home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / boyandoc.arc / BOYAN-D3.DOC next >
Encoding:
Text File  |  1987-07-26  |  164.6 KB  |  3,958 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.          /===========================================================\
  7.          |                                                           |
  8.          |                                                           |
  9.          |                 B O Y A N  Communications                 |
  10.          |                 -------------------------                 |
  11.          |                                                           |
  12.          |                                                           |
  13.          |                 Version D3:  July 26, 1987                |
  14.          |          (C) Copyright 1986,1987 by Justin Boyan          |
  15.          |          ---------------------------------------          |
  16.          |                                                           |
  17.          |                                                           |
  18.          |                        Justin Boyan                       |
  19.          |                    9458 Two Hills Court                   |
  20.          |                    Columbia, MD.  21045                   |
  21.          |                                                           |
  22.          |                    BBS:  (301)-495-7323                   |
  23.          |                    --------------------                   |
  24.          |                                                           |
  25.          |                                                           |
  26.          \===========================================================/
  27.  
  28.  
  29.  
  30.                                 Table of Contents
  31.  
  32.  
  33.          Chapter 1  Introduction                                     1
  34.             1.1  What makes BOYAN special? . . . . . . . . . . . . . 1
  35.             1.2  Using This Manual . . . . . . . . . . . . . . . . . 2
  36.             1.3  User Licensing Agreement  . . . . . . . . . . . . . 3
  37.             1.4  Corporate Licensing Agreement . . . . . . . . . . . 3
  38.             1.5  User Groups . . . . . . . . . . . . . . . . . . . . 3
  39.             1.6  Reviewers . . . . . . . . . . . . . . . . . . . . . 4
  40.            Registration form . . . . . . . . . . . . . . . . . . . . 5
  41.  
  42.          Chapter 2  Starting BOYAN                                   6
  43.             2.1  System Requirements . . . . . . . . . . . . . . . . 6
  44.             2.2  Setting Up BOYAN On Disk  . . . . . . . . . . . . . 6
  45.             2.3  Running BOYAN for the First Time  . . . . . . . . . 6
  46.             2.4  The World of BOYAN  . . . . . . . . . . . . . . . . 7
  47.                2.4.1  The Status Line  . . . . . . . . . . . . . . . 7
  48.                2.4.2  Go Back - <ESC>  . . . . . . . . . . . . . . . 8
  49.                2.4.3  The Help System  . . . . . . . . . . . . . . . 8
  50.                2.4.4  The Line Editor  . . . . . . . . . . . . . . . 8
  51.             2.5  Customizing BOYAN - <Alt-C> . . . . . . . . . . . . 9
  52.                2.5.1  Config Area "A" -- Computer Setup  . . . . . . 9
  53.                2.5.2  Config Area "B" -- Disk Setup  . . . . . . .  10
  54.                2.5.3  Config Area "C"  --  Modem setup . . . . . .  12
  55.                2.5.4  Config Area "D" -- Modem-specific Macros . .  13
  56.                2.5.5  Config Area "E" -- Shortcut Macros . . . . .  15
  57.                2.5.6  Config Area "F" -- Keys Alt-1 to Alt-0 . . .  16
  58.                2.5.7  Config Area "G" -- Keys F1 to F10  . . . . .  16
  59.                2.5.8  Config Area "H" -- Keys Ctrl-F1 to Ctrl-F10 . 16
  60.                2.5.9  Config Area "I" -- Keys Shft-F1 to Shft-F10 . 16
  61.  
  62.  
  63.                                        i
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                2.5.10  Config Area "J" -- Keys Alt-F1 to Alt-F10 .  16
  70.                2.5.11  Config Area "K" -- Timers, Miscellaneous  .  16
  71.                2.5.12  Config Area "L" -- Translation Table  . . .  17
  72.                2.5.13  Config Area "M" -- External protocols . . .  18
  73.                2.5.14  Personal Configuration Note Space . . . . .  19
  74.  
  75.          Chapter 3  BOYAN Command Capabilities                      20
  76.             3.1  <Ctrl-Home> Help Menu . . . . . . . . . . . . . .  20
  77.             3.2  <Alt-X> Exit BOYAN  . . . . . . . . . . . . . . .  20
  78.             3.3  <Alt-Z> Zap (Clear) Screen  . . . . . . . . . . .  20
  79.             3.4  <Alt-B> Beeps and Bells Toggle  . . . . . . . . .  21
  80.             3.5  <Alt-E> Echo Keyboard Toggle  . . . . . . . . . .  21
  81.             3.6  <Shift-Tab> Add Linefeeds Toggle  . . . . . . . .  21
  82.             3.7  <Alt-G> Gossip Mode Toggle  . . . . . . . . . . .  21
  83.             3.8  <Alt-A> ANSI Graphics Toggle  . . . . . . . . . .  21
  84.             3.9  <Alt-U> Use Default Text Color  . . . . . . . . .  22
  85.             3.10  <Alt-T> Translate Table Toggle . . . . . . . . .  22
  86.             3.11  <Alt-S> Save Screen Image to Disk  . . . . . . .  22
  87.             3.12  <Shift-PrtSc> Save Screen Image to Printer . . .  22
  88.             3.13  <Ctrl-PrtSc> Printer Log Toggle  . . . . . . . .  22
  89.             3.14  <Alt-L> Log to Disk Toggle . . . . . . . . . . .  22
  90.             3.15  <Alt-P> Parameter Change . . . . . . . . . . . .  23
  91.             3.16  <Alt-D> Dial a System  . . . . . . . . . . . . .  23
  92.                3.16.1  Manual Dialing  . . . . . . . . . . . . . .  23
  93.                3.16.2  Code Number Dialing . . . . . . . . . . . .  23
  94.                3.16.3  After Dialing . . . . . . . . . . . . . . .  24
  95.                3.16.4  The Dialing Directory . . . . . . . . . . .  24
  96.                3.16.5  Long-Distance Dialing Prefixes  . . . . . .  26
  97.                3.16.6  Uniform Dialing Prefixes  . . . . . . . . .  26
  98.                3.16.7  Automatic Logon Scripts . . . . . . . . . .  27
  99.             3.17  <Alt-Q> Queue Redialing  . . . . . . . . . . . .  27
  100.             3.18  <Alt-H> Hang Up Modem  . . . . . . . . . . . . .  28
  101.             3.19  <Ctrl-End> Send Modem Break Signal . . . . . . .  28
  102.             3.20  BOYAN File Transfers . . . . . . . . . . . . . .  28
  103.                3.20.1  Auto-Find Filename Feature  . . . . . . . .  29
  104.                3.20.2  <PgUp> Upload File  . . . . . . . . . . . .  29
  105.                3.20.3  Uploading a Message . . . . . . . . . . . .  30
  106.                3.20.4  <PgDn> Download File  . . . . . . . . . . .  30
  107.                3.20.5  External Protocol Transfers . . . . . . . .  31
  108.             3.21  The BOYAN.USE "Usage Log" File . . . . . . . . .  31
  109.             3.22  <Del> Directory File Manager . . . . . . . . . .  32
  110.             3.23  <Alt-F> Free Space on Disk . . . . . . . . . . .  33
  111.             3.24  <Alt-I> Information About a File's Size  . . . .  33
  112.             3.25  <Alt-N> New Default Drive/Directory  . . . . . .  33
  113.             3.26  <Ins> Issue DOS Command  . . . . . . . . . . . .  33
  114.             3.27  <Alt-J> Jump to DOS  . . . . . . . . . . . . . .  34
  115.             3.28  <Alt-V> View File  . . . . . . . . . . . . . . .  34
  116.             3.29  <Up-Arrow> Scroll-Back Buffer  . . . . . . . . .  34
  117.             3.30  <Alt-M> Enter Macro Manually . . . . . . . . . .  35
  118.             3.31  <Alt-R> Run Block from Script File . . . . . . .  35
  119.             3.32  BOYAN's Backspace Editor . . . . . . . . . . . .  36
  120.                3.32.1  <Backspace> Erase Previous Character  . . .  36
  121.                3.32.2  <LeftArrow> Erase Previous Character  . . .  36
  122.                3.32.3  <Ctrl-Backspace> Erase Previous Word  . . .  36
  123.                3.32.4  <Ctrl-LeftArrow> Erase Previous Word  . . .  36
  124.  
  125.  
  126.                                        ii
  127.  
  128.  
  129.  
  130.  
  131.  
  132.                3.32.5  <RightArrow> Un-erase Character . . . . . .  37
  133.                3.32.6  <Ctrl-RightArrow> Un-erase Word . . . . . .  37
  134.                3.32.7  Using the Backspace Editor  . . . . . . . .  37
  135.             3.33  Common Questions and Answers . . . . . . . . . .  37
  136.  
  137.          Appendix A  Automating BOYAN's Operation                   39
  138.             A.1  Introduction  . . . . . . . . . . . . . . . . . .  39
  139.             A.2  Overview  . . . . . . . . . . . . . . . . . . . .  39
  140.             A.3  The Macro/Script Command Set  . . . . . . . . . .  40
  141.             A.4  Definitions . . . . . . . . . . . . . . . . . . .  40
  142.             A.5  Basic Commands  . . . . . . . . . . . . . . . . .  40
  143.             A.6  Pause Commands  . . . . . . . . . . . . . . . . .  41
  144.             A.7  Input/Output Commands . . . . . . . . . . . . . .  41
  145.             A.8  Modem Commands  . . . . . . . . . . . . . . . . .  43
  146.             A.9  Conditional Commands  . . . . . . . . . . . . . .  45
  147.             A.10  DOS/File Commands  . . . . . . . . . . . . . . .  46
  148.             A.11  Miscellaneous Commands . . . . . . . . . . . . .  47
  149.             A.12  Macro String Replacements  . . . . . . . . . . .  48
  150.             A.13  Macro Flow Commands  . . . . . . . . . . . . . .  49
  151.             A.14  BOYAN Script Files . . . . . . . . . . . . . . .  49
  152.             A.15  Logon Scripts  . . . . . . . . . . . . . . . . .  50
  153.             A.16  Automatic Unattended Session Scripts . . . . . .  50
  154.             A.17  Running Script Files . . . . . . . . . . . . . .  50
  155.             A.18  Script Flow Commands . . . . . . . . . . . . . .  51
  156.             A.19  Script Variable Commands . . . . . . . . . . . .  52
  157.             A.20  Macro Command Summary  . . . . . . . . . . . . .  52
  158.             A.21  Macro Examples . . . . . . . . . . . . . . . . .  53
  159.             A.22  Script Examples  . . . . . . . . . . . . . . . .  54
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.                                       iii
  190.  
  191.  
  192.  
  193.     BOYAN-D3 Communications          (C) Copyright 1986,1987         Page 1
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                    Chapter 1
  203.  
  204.                                  Introduction
  205.  
  206.  
  207.     1.1  What makes BOYAN special?
  208.  
  209.  
  210.        BOYAN  is a powerful communications package for  the  IBM-PC.    Its
  211.     flexibility, speed, and ease-of-use make BOYAN practical for anyone who
  212.     ever needs to use a modem.  Here is a partial list of BOYAN's features:
  213.  
  214.      - BOYAN supports interrupt-driven communications with  practically all
  215.        modems at 9600, 4800, 2400, 1200, and 300 baud.  (page 12)
  216.  
  217.      - When stuck,  you can get context-sensitive help screens anytime with
  218.        the <Ctrl-Home> key combination.  (page 8)
  219.  
  220.      - "Back up" or cancel  the  current action anytime with the <Esc> key.
  221.        (page 8)
  222.  
  223.      - Reliable  file transfers use a wide  variety  of  common  protocols.
  224.        Furthermore, any additional protocol can be  configured  into BOYAN.
  225.        BOYAN's famous "automatic filename entry"  feature  means  you never
  226.        have to type a filename twice.  (page 28)
  227.  
  228.      - BOYAN saves you time and money by allowing you  to  upload  messages
  229.        you have prepared off-line.    Another  exclusive:  BOYAN determines
  230.        the line prompt character  and  handles  awkward "word wraps." (page
  231.        30)
  232.  
  233.      - An  extensive  script  language  with  well  over  100 commands  can
  234.        automate  all  communication  needs.    Scripts   are   modular  and
  235.        recursive.  You may assign any  series  of BOYAN actions to a single
  236.        keystroke.  (appendix)
  237.  
  238.      - A status line  always  keeps you informed of the currently-connected
  239.        system,  the  elapsed  time  of  the  call,  and  the script file in
  240.        control.  (page 7)
  241.  
  242.      - BOYAN maintains a "usage  log"  that records the length of all modem
  243.        connections  and  the  efficiency of all file  transfers  for  later
  244.        reference.  This can aid with phone records, for example. (page 31)
  245.  
  246.      - BOYAN works with DOS at all times.  Issuing any DOS command, running
  247.        any  program, and entering DOS temporarily  are  possible  within  a
  248.        communication session.  A full built-in file manager  allows  you to
  249.        scan directories, copying and  viewing  files at the touch of a key.
  250.  
  251.  
  252.     Section 1.0                                                      Page 1
  253.  
  254.  
  255.  
  256.     BOYAN-D3 Communications          (C) Copyright 1986,1987         Page 2
  257.  
  258.  
  259.        BOYAN works equally well with  floppy  or  hard  disk-based systems.
  260.        (page 32)
  261.  
  262.      - A dialing directory maintains  names,  numbers,  parameters, default
  263.        file transfer  protocols, logon scripts, and the last date connected
  264.        for your 200 most-used systems.  Editing, sorting by name or number,
  265.        and printing the list can be done within BOYAN.  (page 24)
  266.  
  267.      - A 20-number "redialing queue" automatically stores the numbers which
  268.        you dial but fail to connect.  When you desire,  BOYAN automatically
  269.        redials  each of the numbers in turn, showing  the  status  of  each
  270.        system  in  a full-screen display.  Numbers  may  be  added  to  and
  271.        deleted from the queue at any time.  (page 27)
  272.  
  273.      - A "scroll-back buffer" fills all available memory.  At any time, you
  274.        can page through  the  text  which  has  scrolled off the top of the
  275.        screen.    Within  the  buffer,  you  can  locate specific  strings,
  276.        automatically move to the beginning of the current session, and mark
  277.        passages to be filed to disk or printed.  (page 34)
  278.  
  279.      - BOYAN's Line Editor facilitates entering  and  editing  responses to
  280.        BOYAN's questions.  (page 8)
  281.  
  282.      - A "gossip  mode" allows clear on-line conversation between two modem
  283.        users.  (page 21)
  284.  
  285.      - BOYAN's exclusive "backspace editor" means  that  any  typing errors
  286.        can  be  quickly  corrected without retyping any erased words.  Text
  287.        can be inserted or deleted on a line at any time.  (page 36)
  288.  
  289.      - ANSI emulation,  configurable  filter  tables,  screen  dumps,  disk
  290.        logging, printer  logging,  automatic  modem  speed-detection, modem
  291.        parameters, and other options make BOYAN superior  for microcomputer
  292.        communications.  (pages 20-37)
  293.  
  294.  
  295.     1.2  Using This Manual
  296.  
  297.  
  298.        BOYAN is  generally self-explanatory.  Its commands are mnemonic and
  299.     similar to those of many older comm programs; on-line help  screens are
  300.     available at any time by pressing <Ctrl-Home>.   Experienced  users and
  301.     new  users alike will be able to use  BOYAN  effectively  without  ever
  302.     reading this manual.
  303.  
  304.        By necessity, however,  the  help screens only summarize rather than
  305.     fully explain BOYAN's features.    The complete information is here.  I
  306.     advise  printing  this  manual (if possible) and trying each command on
  307.     your  PC as it is described.  This way you will realize the full  power
  308.     of BOYAN.
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.     Section 1.1                                                      Page 2
  316.  
  317.  
  318.  
  319.     BOYAN-D3 Communications          (C) Copyright 1986,1987         Page 3
  320.  
  321.  
  322.     1.3  User Licensing Agreement
  323.  
  324.  
  325.        I have  spent many hours designing, programming, and debugging BOYAN
  326.     in order to raise money for  my  college  education.  BOYAN is not free
  327.     software.   You  are  granted  a limited license to use my product on a
  328.     trial  basis  only.   If you continue using BOYAN, you must register by
  329.     sending a check for $35 per copy to
  330.  
  331.          Justin Boyan
  332.          9458 Two Hills Court
  333.          Columbia, MD  21045
  334.  
  335.     If you send me either an  additional  $10  or a stamped disk mailer and
  336.     diskette, I will be happy to mail out  a  copy  of  the program to you.
  337.     Registered users will receive  a  user ID by mail and privileged access
  338.     to  the  BOYAN  Support  BBS.   A form is included on page 5  for  your
  339.     registration  and  comments.    I  will attend to  your  correspondence
  340.     immediately.  I can also be reached on the BOYAN Support BBS:
  341.  
  342.          (301)-495-7323, 24 hours/day, 1200/2400/9600 baud MNP
  343.  
  344.     This  BBS,  run   by   Bruce  Felstein,  allows  immediate  access  for
  345.     downloading the latest  enhancements.    Special  BOYAN  information is
  346.     available for registered users.
  347.  
  348.        Users may distribute  copies  of  BOYAN  only if the BOYAN files are
  349.     unmodified and this full BOYAN-D3.DOC  file is included.  Again, please
  350.     don't take advantage of my work by using my program without sending the
  351.     license fee.
  352.  
  353.  
  354.     1.4  Corporate Licensing Agreement
  355.  
  356.  
  357.        BOYAN's ease-of-use and flexibility suits it well for commercial and
  358.     institutional use.  Commercial users are granted a  limited  license to
  359.     use BOYAN on  a  trial basis for no more than 14 days.  After the trial
  360.     period, the corporation must register one copy of BOYAN for  each modem
  361.     on which BOYAN could be used.  Any use of BOYAN beyond the trial period
  362.     is a copyright violation.
  363.  
  364.        Discounts below the $35/copy price are available on purchases of ten
  365.     or  more  copies of BOYAN.  In  addition,  a  site  license  permitting
  366.     unlimited copying within the licensed institution is  available; please
  367.     write or call for details.  If your  corporation  needs  an  invoice to
  368.     generate payment, send a brief letter  of  interest and I will mail one
  369.     out.
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.     Section 1.3                                                      Page 3
  379.  
  380.  
  381.  
  382.     BOYAN-D3 Communications          (C) Copyright 1986,1987         Page 4
  383.  
  384.  
  385.     1.5  User Groups
  386.  
  387.  
  388.        PC User Groups are welcome to add BOYAN to their  software libraries
  389.     as  long as 1) it is completely unmodified, 2) a diskette fee of $5  or
  390.     less is charged, and 3)  the documentation with the licensing agreement
  391.     is included.   I  would  also  appreciate notification (by BBS or mail)
  392.     that BOYAN is  included  in  your  library.   If you have received this
  393.     software through a user group,  please understand that the diskette fee
  394.     paid to the club DOES NOT constitute licensing the  software,  and  you
  395.     must still register if you decide to use BOYAN after the trial period.
  396.  
  397.  
  398.     1.6  Reviewers
  399.  
  400.  
  401.        If you are writing a review  of  my program for publication, I would
  402.     be happy to talk to  you.  Please call the Support BBS and I will leave
  403.     my home  phone  number.    I would also appreciate seeing a copy of any
  404.     printed reviews.  Thank you.
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.     Section 1.5                                                      Page 4
  442.  
  443.  
  444.  
  445.  
  446.  
  447.     =======================================================================
  448.     BOYAN Registration Form               Version D3              July 1987
  449.     -----------------------------------------------------------------------
  450.  
  451.        I  would like to register ______  copies  of  BOYAN  Communications.
  452.     Please mail  me  a  serial  number for the BOYAN Support Board.  I have
  453.     enclosed a check or money order  for  $35  per copy made out to "Justin
  454.     Boyan."
  455.  
  456.  
  457.     Name:    ______________________________________________________________
  458.  
  459.     Address: ______________________________________________________________
  460.  
  461.              ______________________________________________________________
  462.  
  463.              ______________________________________________________________
  464.  
  465.     Computer Equipment: ___________________________________________________
  466.  
  467.     Comments: _____________________________________________________________
  468.  
  469.       _____________________________________________________________________
  470.  
  471.       _____________________________________________________________________
  472.  
  473.       _____________________________________________________________________
  474.  
  475.       _____________________________________________________________________
  476.  
  477.       _____________________________________________________________________
  478.  
  479.       _____________________________________________________________________
  480.  
  481.       _____________________________________________________________________
  482.  
  483.       _____________________________________________________________________
  484.  
  485.       _____________________________________________________________________
  486.     =======================================================================
  487.  
  488.                                                                Justin Boyan
  489.                                                        9458 Two Hills Court
  490.                                                        Columbia, Md.  21045
  491.  
  492.     =======================================================================
  493.  
  494.  
  495.  
  496.     BOYAN-D3 Communications          (C) Copyright 1986,1987         Page 6
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.                                    Chapter 2
  506.  
  507.                                 Starting BOYAN
  508.  
  509.  
  510.     2.1  System Requirements
  511.  
  512.  
  513.     BOYAN has the following minimal requirements:
  514.  
  515.      - IBM PC, XT, AT, or compatible with at least 192K of memory
  516.  
  517.      - DOS 2.0 or later
  518.  
  519.      - One floppy diskette drive or hard disk
  520.  
  521.      - An  internal  modem  card  OR  an  asynchronous  communications card
  522.        connected to either an external modem or another computer
  523.  
  524.      - Any 80-column monochrome or color display
  525.  
  526.        If you also have a printer or more than 256K  of  memory, BOYAN will
  527.     utilize them fully.
  528.  
  529.  
  530.     2.2  Setting Up BOYAN On Disk
  531.  
  532.  
  533.        Use  the  ARC  program  (or  equivalent) to extract  the  BOYAN.COM,
  534.     BOYAN.000, and BOYAN.HLP files  from  the  BOYAN-D3.ARC archive.  These
  535.     files should be  placed  on  a  single formatted diskette; or, for hard
  536.     disk-based systems, within a single subdirectory.
  537.  
  538.  
  539.     2.3  Running BOYAN for the First Time
  540.  
  541.  
  542.        Before starting, be sure that your modem is properly installed (your
  543.     modem manual should have  complete  instructions).    If your modem has
  544.     toggle switches for Data Terminal  Ready  and  Carrier  Detect signals,
  545.     switch them so that these signals are enabled rather than always set to
  546.     on.
  547.  
  548.        You must also instruct DOS to allow at least twelve open  files with
  549.     a CONFIG.SYS file.  If your  startup  disk has no CONFIG.SYS file, type
  550.     the following from DOS:
  551.  
  552.  
  553.  
  554.  
  555.     Section 2.0                                                      Page 6
  556.  
  557.  
  558.  
  559.     BOYAN-D3 Communications          (C) Copyright 1986,1987         Page 7
  560.  
  561.  
  562.          COPY CON \CONFIG.SYS
  563.          files = 12 <ctrl-Z>
  564.  
  565.     When you reboot, the new DOS configuration will be in effect.
  566.  
  567.        The BOYAN.COM, BOYAN.000, and BOYAN.HLP  files should all be in your
  568.     current drive and  subdirectory.    When  you are ready to start BOYAN,
  569.     simply  type  BOYAN  at the DOS prompt.  If BOYAN  cannot  fit  in  the
  570.     available memory, it  will  tell  you  so  and abort.  If this happens,
  571.     reboot without installing any memory-resident programs, and  try again.
  572.     BOYAN should load without a hitch.
  573.  
  574.        When BOYAN starts properly, you will be greeted,  "Welcome  to BOYAN
  575.     version D3 communications!"    You  will  have  to  answer  three basic
  576.     questions:  what serial port does  your  modem use (Com1 or Com2), what
  577.     speed should BOYAN default to, and what parity should BOYAN default to.
  578.     Remember, pressing <Esc> will allow you to abort at any time.
  579.  
  580.        After you have answered the three questions, a  welcome  screen will
  581.     pop up while  BOYAN  briefly  initializes.    The  following  files are
  582.     created by BOYAN during this process:
  583.  
  584.     BOYAN.CNF        (1024   bytes)  Information  specific  to  your   PC's
  585.                      configuration.
  586.  
  587.     BOYAN.MAC        (6480  bytes) The 70 programmable function-key  macros
  588.                      and modem commands.
  589.  
  590.     BOYAN.FON        (14,000 bytes) The 200-entry dialing directory.
  591.     Altogether, then, there  are  six  files  which BOYAN needs in order to
  592.     operate.  The next time  you  run  BOYAN,  all  files  will  already be
  593.     present in the directory, and initialization will occur automatically.
  594.  
  595.        When BOYAN's  initialization is complete, the message "Turn modem on
  596.     and press any  key" will appear on the status line at the bottom of the
  597.     screen.    Press  the   spacebar;   the   screen   will  clear,  and  a
  598.     "Communications ready" message will appear.
  599.  
  600.  
  601.     2.4  The World of BOYAN
  602.  
  603.  
  604.        Welcome!    BOYAN  is now in  "terminal  mode,"  ready  to  begin  a
  605.     communications session.  You may now type modem  commands  directly, or
  606.     use BOYAN's many built-in commands.   There are several features common
  607.     to the whole program that you should now become familiar with.
  608.  
  609.  
  610.     2.4.1  The Status Line
  611.  
  612.  
  613.        The bottom line of the screen is called the Status Line.  BOYAN uses
  614.     the first half of this line to periodically  interact  with  you.   The
  615.     middle part of the line tells you which version of BOYAN you are using;
  616.  
  617.  
  618.     Section 2.3                                                      Page 7
  619.  
  620.  
  621.  
  622.     BOYAN-D3 Communications          (C) Copyright 1986,1987         Page 8
  623.  
  624.  
  625.     when a "script file"  takes  control,  its  name flashes there instead.
  626.     Finally,  the  right  part   of   the   line  gives  you  miscellaneous
  627.     information.  When your modem has  made  a connection, this part of the
  628.     line shows the name of the on-line system as well  as  the elapsed time
  629.     of the call.
  630.  
  631.  
  632.     2.4.2  Go Back - <ESC>
  633.  
  634.  
  635.        Whenever you need to "go back" or abort your current  operation with
  636.     BOYAN, press the <Esc> key.  This is one of BOYAN's  handiest features;
  637.     you can never get stuck.  Remember, <Esc> to go back.
  638.  
  639.  
  640.     2.4.3  The Help System
  641.  
  642.  
  643.        BOYAN's context  help screens are accessible anytime with the <Ctrl-
  644.     Home>  key  combination.    16  different  screens  of information  are
  645.     available,  and  when  you   press   <Ctrl-Home>   BOYAN  automatically
  646.     determines the one most likely to help you.  If you  wish  to  scan all
  647.     the help screens at any time, press <Ctrl-Home> while  viewing  a  help
  648.     screen.  This will bring up help  page  B,  the  Help  Screen  Table of
  649.     Contents.  Instructions there explain how to use the <PgUp>  and <PgDn>
  650.     keys  to scroll through all 16 help pages.  You can also instantly view
  651.     any of the screens by pressing the letter associated with it.
  652.  
  653.        A special help  screen  is  the  BOYAN Command List, the help screen
  654.     which appears if you press <Ctrl-Home> from terminal mode.  Any command
  655.     from the list can be chosen and executed while you are viewing the help
  656.     screen.  In  addition,  in  the  lower-right quarter of the screen, the
  657.     current on/off state of each of the "toggle" commands is shown.   BOYAN
  658.     commands are described from page 20 to page 37.
  659.  
  660.  
  661.     2.4.4  The Line Editor
  662.  
  663.  
  664.        When  using  BOYAN's  interactive  commands,  you  are  often  asked
  665.     questions.  Sometimes BOYAN will  provide a default value; other times,
  666.     you will have to type your response from scratch.  In either case, your
  667.     response  is  entered with the BOYAN Line  Editor.    The  Line  Editor
  668.     provides many commands for you to easily edit any entry before pressing
  669.     <Return>.  To see a description  of  all the Line Editor commands, view
  670.     help screen "D" by keying the <Ctrl-Home><Ctrl-Home><D> sequence at any
  671.     time.    Note  that a flashing cursor indicates that Insert Mode is on,
  672.     and  a  block cursor means that Overwrite Mode is on.   The  <Ins>  key
  673.     switches between these two modes.
  674.  
  675.        Anxious to try an example?  From terminal mode, press the <Del> key.
  676.     You will  see  the  "DIR"  prompt.    Type  BOYAN.*  .  Before pressing
  677.     <Return>,  experiment  a  little with the Line Editor's commands.  When
  678.     you do press <Return>, you will see a sorted listing  of  the files you
  679.  
  680.  
  681.     Section 2.4                                                      Page 8
  682.  
  683.  
  684.  
  685.     BOYAN-D3 Communications          (C) Copyright 1986,1987         Page 9
  686.  
  687.  
  688.     specified.  Press <Esc> when you are ready to return to  terminal mode.
  689.     You will find the Line Editor  easy  and convenient after a little time
  690.     with BOYAN.
  691.  
  692.  
  693.     2.5  Customizing BOYAN - <Alt-C>
  694.  
  695.  
  696.        BOYAN provides dozens of configurable options for  great flexibility
  697.     and power.  Luckily,  most  of these options will be perfectly suitable
  698.     at their preset (default)  values.    However, a built-in configuration
  699.     program  makes  BOYAN  easy  to  customize.  Call up the  configuration
  700.     section  by pressing <Alt-C> (hold down the Alt key and hit the C key).
  701.     A  menu  of  options lettered A-M should appear.  Although the menu may
  702.     look  formidable,  only the first four areas  are  of  concern  to  the
  703.     novice.    Any  changes you make are automatically stored on disk to be
  704.     used the next time you run BOYAN.
  705.  
  706.  
  707.     2.5.1  Config Area "A" -- Computer Setup
  708.  
  709.  
  710.        Press <A> to see this menu.    Eleven options are listed, along with
  711.     their present values.    To  change  any option, first hit the option's
  712.     letter  (A-K), then enter the new value.  As you edit an entry you  may
  713.     use the BOYAN Line Editor (see page 8).  You may also press <Ctrl-Home>
  714.     for complete explanations at any time.
  715.  
  716.      - <A>  Normal text color, default = 7.   This  number  represents  the
  717.        color  of  the  text   coming   to  and  from  the  modem  during  a
  718.        communications session.   If  you  have  a color monitor and wish to
  719.        change this value,  select  a  number  from  1 to 127 from the color
  720.        chart at the right.  Press <Return> after typing the number.
  721.  
  722.      - <B>  Menu  and  help screen color, default = 112.  BOYAN's menus and
  723.        help screens will be displayed in this color.
  724.  
  725.      - <C> Status line color, default = 112.
  726.  
  727.      - <D> Enhanced color,  default  =  15.   When BOYAN needs to highlight
  728.        text on the screen for any reason it will use this color.  This must
  729.        be different than the Normal text color in <A>.
  730.  
  731.      - <E> Scroll-back color, default  =  7.    Text in BOYAN's scroll-back
  732.        buffer will appear in this color.
  733.  
  734.      - <F>  Use dots in menus, default = YES.  BOYAN will enhance its menus
  735.        with small dots if this option is YES.
  736.  
  737.      - <G> Beeps &  Bells,  default  =  ON.    The  value of this item will
  738.        determine  whether BOYAN's sound effects are on  or  off  each  time
  739.        BOYAN  is run.  At any given time while you are using BOYAN you  may
  740.        temporarily toggle the sound  on  or  off  with the <Alt-B> command.
  741.        (page 21)
  742.  
  743.  
  744.     Section 2.4                                                      Page 9
  745.  
  746.  
  747.  
  748.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 10
  749.  
  750.  
  751.      - <H> Alarm  level,  default  =  10.  BOYAN uses its alarm to signal a
  752.        successful redialer connection, the end  of a file transfer, the end
  753.        of a script, and a modem disconnect.  Change the volume level of the
  754.        alarm by setting this field between 1 (low buzzing)  and  10  (loud,
  755.        shrill beep).   0  turns  the  alarm  off altogether.  Note that the
  756.        alarm works independently of the Beeps & Bells setting.
  757.  
  758.      - <I> Alt-D goes straight to Dialing Directory, default = NO.  If this
  759.        is NO,  you  have  a  chance to enter a phone number or dialing code
  760.        before viewing the dialing directory.   Switching this to YES causes
  761.        the phone list to  be  automatically displayed every time you dial a
  762.        number.  (page 24)
  763.  
  764.      - <J> Memory (in K) for DOS  shell,  default  = 105.  BOYAN uses about
  765.        150 K for  itself;  all  remaining  memory  is  divided  between the
  766.        scroll-back buffer (page 34) and the DOS shell (page  34).    Larger
  767.        values for this option will allow you to run  larger  programs  from
  768.        within BOYAN.  If you need to run Lotus 1-2-3 from within BOYAN, for
  769.        example, you must  allot at least 100 K of memory for the shell.  To
  770.        use the "Zmodem" external protocol, you must reserve at least 105 K.
  771.        Other external  protocols, like "Kermit" and "Sealink," work with as
  772.        little as 65 K.   Smaller  values  will  increase  the  size  of the
  773.        scroll-back buffer.  To maximize the size of the scroll-back buffer,
  774.        you may set this value to  0,  but  then BOYAN commands like "Copy a
  775.        file"  will  be  disabled.  25 K is the smallest positive value that
  776.        will enable DOS command use from within BOYAN.
  777.  
  778.      - <K> Initialize printer  string,  no default.  Several BOYAN commands
  779.        use a printer.  Each time  BOYAN  accesses the printer, it gives you
  780.        the opportunity to automatically advance  the paper by line or page,
  781.        send a brief message to the printer, and  send  this "initialization
  782.        string."   If you have a printer that needs  to  be initialized with
  783.        special printer codes  (for  example,  to  set up 8 lines per inch),
  784.        enter  those  codes  here.    The  four  characters    "  ^ { '  are
  785.        interpreted  in the same way as macros; for  example,  to  send  the
  786.        escape character to the printer, include  ^[  in  your  string.  See
  787.        page 22 for details on BOYAN's printer interface.
  788.  
  789.  
  790.     2.5.2  Config Area "B" -- Disk Setup
  791.  
  792.  
  793.        Press  a  letter  from <A> through <M> to edit these entries, all of
  794.     which  concern disk operations and file  transfers.    Remember,  press
  795.     <Ctrl-Home> for complete help.
  796.  
  797.      - <A> Auto-sort disk directory, default = YES.  When BOYAN  displays a
  798.        disk directory it  will  alphabetize it automatically if this option
  799.        is YES.
  800.  
  801.      - <B> View file command, default =  TYPE.    To view the contents of a
  802.        text file during a communication session, BOYAN sends  a  command to
  803.        DOS consisting of the  View  file command + the filename (e.g., TYPE
  804.        FILENAME.EXT).    If  you  own  another list utility such as  Vernon
  805.  
  806.  
  807.     Section 2.5                                                     Page 10
  808.  
  809.  
  810.  
  811.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 11
  812.  
  813.  
  814.        Buerg's LIST program, you may use its name for this  option instead.
  815.        You could even put the name of your word processor here.
  816.  
  817.      - <C>  Filename for screen dumps, default  =  SCRNDUMP.TXT.    BOYAN's
  818.        <Alt-S>  command  saves  a copy of the current screen to a disk file
  819.        (page 22).  Use this option to specify the subdirectory and filename
  820.        BOYAN should use for this file.
  821.  
  822.      - <D> Log filename, default = BOYAN.LOG.  BOYAN can automatically save
  823.        all incoming text to a disk file (page 22).  Although you can change
  824.        this name each time you log to disk, the  default  subdirectory  and
  825.        filename should be set here.
  826.  
  827.      - <E> Phone list filename, default  = NUMBERS.TXT.  BOYAN can generate
  828.        a  readable  text  file  listing  of the phone directory (page  26).
  829.        Specify this file's default subdirectory and filename here.
  830.  
  831.      - <F> Scroll-back  filename, default = SCRBACK.LOG.  When viewing text
  832.        in the scroll-back  buffer  you  may  mark  any region of text to be
  833.        filed to disk (page 35).  Specify this  file's  default subdirectory
  834.        and filename here.
  835.  
  836.      - <G> Directory for file downloads,  no default.  When BOYAN transfers
  837.        a  file  from  a  remote  computer  to  your  PC (download), it will
  838.        automatically place the file in this drive and subdirectory.  A full
  839.        drive + path specification is legal; BOYAN will use the current path
  840.        if  this  field  is left empty.  You may change  this  default  path
  841.        temporarily at the  start  of  any  transfer, but use this option to
  842.        save your usual choice to disk.
  843.  
  844.      - <H> Directory for  file  uploads,  no  default.  When you transfer a
  845.        file from your PC  to  a remote computer (upload), BOYAN will search
  846.        this directory for the file (see page 30).  If it  is  not  found in
  847.        that directory,  BOYAN  will  automatically  check  the  current DOS
  848.        directory for the file.  As above, you may change this  default path
  849.        at the start of any transfer, but use this option to save your usual
  850.        choice to disk.
  851.  
  852.      - <I>  Maintain BOYAN.USE "usage log" file, default =  YES.    If  you
  853.        select YES, BOYAN will maintain a text file activity log which shows
  854.        a record of all BOYAN connections and file transfers (see page 31).
  855.  
  856.      - <J> Default transfer  protocol,  default  =  X.    BOYAN  version D3
  857.        supports  the  following  methods  of  file  transfer:     [X]modem,
  858.        [R]elaxed-Xmodem,[C]RC-Xmodem,  [Y]modem,  [G]-option   Ymodem,  and
  859.        [A]SCII.    BOYAN  also supports up to  five  user-defined  external
  860.        protocols, such as [Z]modem  and  [K]ermit.  Note that you can still
  861.        use any protocol at any time, no matter what the default.
  862.  
  863.      - <K> Check free disk space, default = YES.  When  this  is YES, BOYAN
  864.        will  automatically  display  the  room  left  on  the drive  before
  865.        downloading a file and while  viewing  the  Directory  File Manager.
  866.        When  this is NO, you must press <Alt-F> in the download menu or <F>
  867.        in the Directory File Manager to accomplish the same result.
  868.  
  869.  
  870.     Section 2.5                                                     Page 11
  871.  
  872.  
  873.  
  874.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 12
  875.  
  876.  
  877.      - <L>  Auto-find   transfer  filename,  default  =  YES.    With  most
  878.        communications programs, transferring a file requires  you  to enter
  879.        the file's name twice: once to the remote computer, and once to your
  880.        PC.  One of BOYAN's most handy features is its  ability  to "lift" a
  881.        filename right off the  screen,  saving you the trouble of typing it
  882.        twice (page 29).  Select "OFF" to disable this feature.
  883.  
  884.      - <M>  Auto-detect  message  upload word wrap, default = OFF.  BOYAN's
  885.        message upload feature  allows  you to prepare messages offline with
  886.        your word processor  and  then  send  them  directly  to  the remote
  887.        message system.  Since  different  systems  allow  different maximum
  888.        lengths for each line of  the  message,  uploaded  message sometimes
  889.        look strangely short on the line, or (worse yet)  they  overrun  the
  890.        line,  causing  word wrap.  When this  feature  is  ON,  BOYAN  will
  891.        automatically  detect when the remote system  word  wraps;  if  this
  892.        happens, BOYAN simply  withholds the end-of-line <Return> character.
  893.        This  works  nicely  with text messages, but may cause graphic boxes
  894.        and  the  like  to align improperly if the message line is too long.
  895.        Note that this feature is OFF by default.
  896.  
  897.      - <N> Seconds for alarm after transfer, default =  4.    After  a file
  898.        transfer has completed, BOYAN will sound the alarm for the number of
  899.        seconds specified here, up to 255.  The sound can be  interrupted by
  900.        pressing any key.
  901.  
  902.  
  903.     2.5.3  Config Area "C"  --  Modem setup
  904.  
  905.  
  906.        Select a letter from <A> through <O> to change any of these entries,
  907.     all concerning your modem.  The defaults for these settings apply  to a
  908.     typical computer with a Hayes modem.
  909.  
  910.      - <A> Communications port.  Toggle this option between  Com1  and Com2
  911.        to specify the serial port which BOYAN should use when it starts up.
  912.        This  can  be  changed  temporarily  during terminal mode  with  the
  913.        Parameter Change command (page 23).
  914.  
  915.      - <B> Baud  rate.    BOYAN  will  automatically  use the baud rate you
  916.        select here (300, 1200, 2400, 4800, or 9600) when it starts  up, but
  917.        this rate can be changed at any time with the <Alt-P>  command (page
  918.        23).
  919.  
  920.      - <C>  Parity.  BOYAN will automatically use  the  parity  you  select
  921.        (None,  Even, Odd) when it starts up, but this can be changed at any
  922.        time  with  the  <Alt-P>  command  (page  23).   Most  systems  will
  923.        communicate with no  parity,  although some mainframes do require an
  924.        even setting.
  925.  
  926.      - <D>  Auto-detect connect speed, default = OFF.   When  this  is  ON,
  927.        BOYAN  will  automatically  set  its  baud rate based on the  number
  928.        returned with the modem connect message after dialing.    In effect,
  929.        using this option allows you to specify your highest modem speed for
  930.  
  931.  
  932.  
  933.     Section 2.5                                                     Page 12
  934.  
  935.  
  936.  
  937.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 13
  938.  
  939.  
  940.        every  dialing  directory  entry,  as  long as your modem returns  a
  941.        message with its connect speed.
  942.  
  943.      - <E> Modem connect message, default = CONNECT.  If your modem gives a
  944.        message upon making a  connection,  enter  that  message here.  Note
  945.        that  "CONNECT" will cover the Hayes  messages  of  "CONNECT  1200,"
  946.        "CONNECT 2400," etc.
  947.  
  948.      - <F>,<G>,<H>,<I> Modem  no  connect  messages,  defaults  =  BUSY, NO
  949.        CARRIER,  NO DIAL TONE, and NO ANSWER.  When your modem sends any of
  950.        the four messages entered here, BOYAN will assume that the attempted
  951.        dialing  was unsuccessful.  If your modem has  fewer  than  four  no
  952.        connect messages, just leave the extra spaces blank.
  953.  
  954.      - <J>  Modem  error message, default = ERROR.    If  BOYAN  sees  this
  955.        message it will know that an error in dialing occurred, and  it will
  956.        not attempt to redial this number.
  957.  
  958.      - <K>  Echo keyboard, default = OFF.  If off, BOYAN will send what you
  959.        type to the  modem only; if on, BOYAN will send what you type to the
  960.        modem and the  screen.    This  may  be  toggled  temporarily during
  961.        communications with the <Alt-E> command. (page 21)
  962.  
  963.      - <L> Add linefeeds, default  =  OFF.  BOYAN will add linefeeds (extra
  964.        line spacing) to incoming  carriage  returns  if  this option is on.
  965.        While using BOYAN you  may  temporarily  toggle  linefeeds on or off
  966.        with the <Shift-Tab> command.  (page 21)
  967.  
  968.      - <M> ANSI Graphics, default = ON.    Some systems may use ANSI Escape
  969.        codes to control cursor positioning and screen colors.    BOYAN will
  970.        ignore  these  codes  if  this  option  is  set  to  OFF.     During
  971.        communications this option may be temporarily toggled with the <Alt-
  972.        A> command. (page 21)
  973.  
  974.      - <N>  Xon/Xoff  Pacing,  default = ON.    Some  systems  support  the
  975.        Xon/Xoff  method  to  pause  and   resume   output.      BOYAN  will
  976.        automatically use Xon/Xoff pacing when this is ON.
  977.  
  978.      - <O>  Use translate table, default = ON.    BOYAN's  translate  table
  979.        allows  you  to   have   BOYAN   filter   or   translate  characters
  980.        automatically as they arrive from  the modem.  The translation table
  981.        is  configured  in  Configuration  Area  "L" (page 17).  BOYAN  will
  982.        ignore the table if this option is set to OFF.    From terminal mode
  983.        you may toggle this option  temporarily  with  the  <Alt-T> command.
  984.        (page 22)
  985.  
  986.  
  987.     2.5.4  Config Area "D" -- Modem-specific Macros
  988.  
  989.  
  990.        A BOYAN "macro" is a line of text, up to  80  characters long, which
  991.     contains instructions and commands BOYAN will follow.  BOYAN recognizes
  992.     well  over 100 different commands which can be  embedded  as  you  like
  993.     within macros.  Detailed instructions for programming macros are in the
  994.  
  995.  
  996.     Section 2.5                                                     Page 13
  997.  
  998.  
  999.  
  1000.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 14
  1001.  
  1002.  
  1003.     appendix (see page 39).  Basically, though, any character in a macro is
  1004.     sent  straight to the modem with the exception  of  the  following  six
  1005.     characters:   "  ^ { ~  ' \
  1006.       1.  The quotation mark "  is  used before any of those six characters
  1007.           if you really  wish  to  send  that  character to the modem.  For
  1008.           example, to send a quotation mark, include "" in your macro.
  1009.  
  1010.       2.  The caret ^ is used to send control characters.  For  example, if
  1011.           the string  ^J is found in a macro, BOYAN  will  send a control-J
  1012.           character.  ^[ sends an Escape character.
  1013.  
  1014.       3.  The  left curly brace { is used to send the return character.  It
  1015.           is equivalent to the  macro  command ^M , or typing <Return> from
  1016.           terminal mode.
  1017.  
  1018.       4.  If the tilde ~ is found in a  macro,  BOYAN  will  pause one-half
  1019.           second.
  1020.  
  1021.       5.  The apostrophe ' is ignored  unless preceded by a quotation mark.
  1022.           (It is used for spacing out BOYAN commands.)
  1023.  
  1024.       6.  Finally,  the  backslash  \ is the BOYAN  macro  command  prefix.
  1025.           BOYAN's Macro Commands generally take  the  form  of  a backslash
  1026.           followed by two letters.  These commands make it possible for you
  1027.           to automate all your communication needs.
  1028.     Configuration areas "D" through  "J"  all  are  used for editing macros
  1029.     with the BOYAN Line Editor (see page 8).
  1030.  
  1031.        The first ten  macros,  in  Config  Area "D", are used internally by
  1032.     BOYAN and are thus  important  to enter correctly.  The defaults should
  1033.     work with all Hayes and Hayes-compatible modems.  Select the  macro you
  1034.     wish to edit by number.
  1035.  
  1036.      - 1. Dialing command prefix, default = ATDT.   If  you  have  an auto-
  1037.        dialing  modem, enter the string which should  be  sent  before  the
  1038.        phone  number when dialing.  Advanced BOYAN  Users:  you  may  embed
  1039.        Macro Commands here, e.g., \ZS  to  clear  the  screen automatically
  1040.        before dialing.
  1041.  
  1042.      - 2. Dialing command suffix, default = { .   This  string  immediately
  1043.        follows the phone number when dialing on an auto-dialing modem.
  1044.  
  1045.      - 3. Modem  reset  sequence,  no  default.    This macro is sent after
  1046.        changing baud rate or parity parameters with the <Alt-P> command.
  1047.  
  1048.      - 4. Hang up  modem  sequence,  default  = ~~~~+++~~~~ATH{ .  When the
  1049.        Hangup Modem <Alt-H> command is used, BOYAN first  attempts  to drop
  1050.        the  Data  Terminal  Ready signal for 1 second.  That should hang up
  1051.        most  modems instantly.  However, if the  carrier  signal  is  still
  1052.        present, then this macro is run.
  1053.  
  1054.      - 5. Cycle current dialing, default = A{ .  Often a modem will take 15
  1055.        or  20  seconds  to determine that the number it has dialed is busy.
  1056.        If you have a modem speaker, BOYAN lets you manually  cycle (cancel)
  1057.  
  1058.  
  1059.     Section 2.5                                                     Page 14
  1060.  
  1061.  
  1062.  
  1063.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 15
  1064.  
  1065.  
  1066.        the dialing attempt as soon as you hear the busy signal.  This macro
  1067.        is  sent  at that time.  The default macro sends the  letter  A  and
  1068.        <Return>, which  cycles  most  Hayes-compatible  modems.    Advanced
  1069.        users: you may use a macro like \DT-~\DT+ to turn the  Data Terminal
  1070.        Ready signal off and on.
  1071.  
  1072.      - 6.  Between  redialing  attempts, no default.  BOYAN has a redialing
  1073.        queue that dials from a list of numbers repeatedly until any  one of
  1074.        them  connects  (page  27).    This  macro  is   sent   after  every
  1075.        unsuccessful  queue  redialing  attempt.    If  your  macro  is  not
  1076.        resetting  properly  during  redialing,  try  using the  \HU   Macro
  1077.        Command here to hang up the modem.
  1078.  
  1079.      - 7. After disconnect, no default.   This macro runs immediately after
  1080.        any disconnection.  For example, you might insert  the  \LD- command
  1081.        to turn off disk  logging,  \RC to restore the default screen color,
  1082.        \QD  to  automatically  resume redialing from numbers  left  in  the
  1083.        queue, or \DI[] to enter the dialing directory.
  1084.  
  1085.      - 8. Expansion; not used by version D3 of BOYAN.
  1086.  
  1087.      - 9. BOYAN start-up macro, no default.  Any macro that you  enter here
  1088.        is executed immediately when BOYAN  is run.  Remember, using BOYAN's
  1089.        macro  command  language  as described in the appendix, you can have
  1090.        BOYAN set its  defaults,  run  a  script,  dial a number, set up the
  1091.        dialing queue, run a DOS program, or even complete an entire session
  1092.        automatically at startup.  Hayes modem users may use this  space for
  1093.        a  string  like   AT&C1&D2&W{  which sets the DTR and carrier detect
  1094.        signals properly.
  1095.  
  1096.      - 10. BOYAN conclude macro,  no  default.  This macro is executed when
  1097.        you exit BOYAN with the <Alt-X> command.
  1098.  
  1099.        If you are just getting started with BOYAN, you should skip  to page
  1100.     6 to learn  about  BOYAN's  many  commands.    Configuration  areas "E"
  1101.     through "M" may  become  useful  to  you after you are comfortable with
  1102.     BOYAN's normal commands.
  1103.  
  1104.  
  1105.     2.5.5  Config Area "E" -- Shortcut Macros
  1106.  
  1107.  
  1108.        These  macros  are  used  in  the macro programming language.   They
  1109.     correspond to the symbols above the  top  row of digits on the keyboard
  1110.     -- the ! @ # $ % ^ & * ( ) symbols.    They  are shortcuts because they
  1111.     may be called by any other macro with  simply  the  backslash  plus the
  1112.     symbol.    In  other  words,  if  I assign macro 13 (#) to  the  string
  1113.     "password",  then  I  can embed the \# string within any other macro to
  1114.     send  "password".  If I assign macro 17 to print the disk directory and
  1115.     download a file, then including \&  within  any macro or script will do
  1116.     the same thing.  Later, if I change these macros, the other macros that
  1117.     call them will all automatically reflect the change.  BOYAN's automatic
  1118.     script  files  (see  the appendix) often  assume  that  macro  11  (\!)
  1119.     contains your first name, macro 12 (\@) contains your  last  name,  and
  1120.  
  1121.  
  1122.     Section 2.5                                                     Page 15
  1123.  
  1124.  
  1125.  
  1126.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 16
  1127.  
  1128.  
  1129.     macro 13 (\#) contains your system password.  Another  common  use  for
  1130.     shortcut macros is long-distance dialing prefixes.  These are explained
  1131.     on page 26.
  1132.  
  1133.  
  1134.     2.5.6  Config Area "F" -- Keys Alt-1 to Alt-0
  1135.  
  1136.  
  1137.        The  macros   in  configuration  areas  "F"  through  "J"  are  each
  1138.     associated  with  a  particular  key  or  key  combination.   During  a
  1139.     communication session, pressing that key combination will  activate the
  1140.     macro entered here.  In this way, ANY BOYAN ACTION OR SERIES OF ACTIONS
  1141.     CAN  BE  DONE WITH A SINGLE KEYPRESS.    The  appendix  describes  many
  1142.     convenient possibilities for  this  unique BOYAN feature.  Macros 21-30
  1143.     are  activated  by  holding  down   the  <Alt>  key  and  pressing  the
  1144.     corresponding digit from <1> to <0> at the top of the keyboard.
  1145.  
  1146.  
  1147.     2.5.7  Config Area "G" -- Keys F1 to F10
  1148.  
  1149.  
  1150.        Macros 31-40 are activated by  pressing  the  corresponding function
  1151.     key from <F1> to <F10> at the left of the keyboard.    For  example, if
  1152.     you enter macro # 33  as    IBM-PC    then pressing <F3> will send that
  1153.     string to the modem.
  1154.  
  1155.  
  1156.     2.5.8  Config Area "H" -- Keys Ctrl-F1 to Ctrl-F10
  1157.  
  1158.  
  1159.        Macros 41-50 are  activated  by  holding  down  the  <Ctrl>  key and
  1160.     pressing the corresponding function key from <F1> to <F10>.
  1161.  
  1162.  
  1163.     2.5.9  Config Area "I" -- Keys Shft-F1 to Shft-F10
  1164.  
  1165.  
  1166.        Macros  51-60  are  activated  by  holding down the <Shift> key  and
  1167.     pressing the corresponding function key from <F1> to <F10>.
  1168.  
  1169.  
  1170.     2.5.10  Config Area "J" -- Keys Alt-F1 to Alt-F10
  1171.  
  1172.  
  1173.        Macros  61-70  are  activated by holding  down  the  <Alt>  key  and
  1174.     pressing the corresponding function key from <F1> to <F10>.
  1175.  
  1176.  
  1177.     2.5.11  Config Area "K" -- Timers, Miscellaneous
  1178.  
  1179.  
  1180.        Select the option to configure by letter (A-F).
  1181.  
  1182.  
  1183.  
  1184.  
  1185.     Section 2.5                                                     Page 16
  1186.  
  1187.  
  1188.  
  1189.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 17
  1190.  
  1191.  
  1192.      - <A> Time to wait for connect, default = 45.  After dialing a number,
  1193.        BOYAN waits this many seconds for a carrier signal, a modem message,
  1194.        or  a  keypress.   If the  timer  expires,  BOYAN  assumes  that  no
  1195.        connection was made.
  1196.  
  1197.      - <B>  Time  to  pause  between  redials,  default  =  3.    After  an
  1198.        unsuccessful dialing attempt from the redialer, BOYAN pauses for the
  1199.        number of seconds specified  here  before running macro # 6 and then
  1200.        continuing to redial.
  1201.  
  1202.      - <C> Drop DTR when  closing  communications port, default = NO.  When
  1203.        you  exit BOYAN or change comm devices, BOYAN  will  drop  the  Data
  1204.        Terminal Ready signal if this toggle is set to YES.
  1205.  
  1206.      - <D>  Modem  carrier  detect  mask,  default  =  7.   Many of BOYAN's
  1207.        features depend on your  modem's  ability  to accurately reflect its
  1208.        carrier status.  Most modems use bit 7 of the modem  status register
  1209.        to indicate the presence of a carrier signal.   (Hayes  modem  users
  1210.        may have to send a special  modem  command as described on page 15.)
  1211.        If BOYAN seems to think you are connected when you aren't,  or vice-
  1212.        versa, then  try  changing  this  number  to  5, 4, or anything that
  1213.        works.
  1214.  
  1215.      - <E> Script handshake timeout,  default  =  30.  BOYAN's macro/script
  1216.        waitfor commands will wait for  the number of seconds specified here
  1217.        before  "timing out" and continuing to the next  command.    If  you
  1218.        enter the maximum value, 255,  then BOYAN will wait indefinitely for
  1219.        a match.  This value can be reset from within a macro or script with
  1220.        the \TO command.
  1221.  
  1222.      - <F> Unattended keyboard timeout,  default  = 10.  When a script file
  1223.        has control, BOYAN flags itself  as "unattended" and will accept the
  1224.        default  responses  to any prompts.  If  you  are  at  the  computer
  1225.        watching the script file run, you can change the responses by typing
  1226.        before the number of seconds specified here has elapsed.  BOYAN will
  1227.        show  a timer counting down your last 10 seconds of time to edit the
  1228.        response before it accepts it.  This value can be reset  from within
  1229.        a macro or script with the \KO command.
  1230.  
  1231.  
  1232.     2.5.12  Config Area "L" -- Translation Table
  1233.  
  1234.  
  1235.        The ASCII character translation and filter table is used if you wish
  1236.     BOYAN  to  automatically  change or remove incoming  characters.    For
  1237.     example, if the square-root symbol (char # 251) appeared erratically on
  1238.     your screen during a  bad  line connection, you could have BOYAN simply
  1239.     filter it out.  Directions are on the screen; a complete  ASCII number-
  1240.     character  table  is  available  by  pressing  <Ctrl-Home>.   During  a
  1241.     communication session you may  turn  the translation table on or off by
  1242.     pressing <Alt-T>.
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.     Section 2.5                                                     Page 17
  1249.  
  1250.  
  1251.  
  1252.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 18
  1253.  
  1254.  
  1255.  
  1256.     2.5.13  Config Area "M" -- External protocols
  1257.  
  1258.  
  1259.        BOYAN provides built-in support for the Xmodem, Relaxed-Xmodem, CRC-
  1260.     Xmodem,  ASCII,  Ymodem,   and   G-option   Ymodem   methods   of  file
  1261.     transmission.  However, BOYAN can also support Kermit, Zmodem, Sealink,
  1262.     Megalink,  and any other protocol methods  by  "shelling"  to  external
  1263.     programs.  BOYAN's procedure for using external protocols is to
  1264.      - Check that the external program exists in the BOYAN home directory.
  1265.  
  1266.      - Make the upload or download path the default drive and directory.
  1267.  
  1268.      - Execute a user-defined macro  which  shells  to the external program
  1269.        with all proper parameters.
  1270.  
  1271.      - When the transfer is complete, change back to  the  previous default
  1272.        drive and directory.
  1273.  
  1274.      - The  transfer  is  considered  successful  if  the  external program
  1275.        terminates with an  errorlevel  of  0  and  (for  downloads)  if the
  1276.        received file is intact.
  1277.     BOYAN needs to be  told  the following about each external protocol you
  1278.     wish to configure:
  1279.      - A protocol name of 1-10 letters.  This is how  the  protocol will be
  1280.        identified in the protocol menu and in the usage log.
  1281.  
  1282.      - A menu selection letter.  Remember, BOYAN keeps  X,R,C,Y,G,A,  and M
  1283.        for its own use.  This  letter  will  be used to select the protocol
  1284.        from the protocol menus and in macro commands.
  1285.  
  1286.      - The name of the external file which is responsible for  handling the
  1287.        transfer.  BOYAN makes  sure  that the file is there before allowing
  1288.        you to select the protocol.
  1289.  
  1290.      - Whether the protocol  needs  to  be  told  the name of the file when
  1291.        downloading.    Some  protocols,  like  Kermit   and   Zmodem,  will
  1292.        automatically receive the filename from the sending program.
  1293.  
  1294.      - Finally,  you must write macros in the  BOYAN  Command  Language  to
  1295.        actually  call  the  external  file.    Most  external file-transfer
  1296.        programs  require parameters after the filename  to  tell  them  the
  1297.        modem device (port 1 or 2),  the  modem speed, the modem parity, and
  1298.        the  name  of  the  file  to  transfer.    For  example, consider  a
  1299.        fictitious "Jmodem" protocol which is  supported  by  the JMODEM.EXE
  1300.        file.  JMODEM.EXE will upload a file with the Jmodem protocol  if it
  1301.        is called in the following format:
  1302.  
  1303.             JMODEM -DEV ? -SPEED ???? -SEND \PATH\FILENAME
  1304.  
  1305.        To write an upload macro, you would use the \DC  command  to issue a
  1306.        DOS Command, \P: to specify that JMODEM.EXE is found in  the default
  1307.        BOYAN directory path, \MD to insert the modem device number,  \MS to
  1308.  
  1309.  
  1310.  
  1311.     Section 2.5                                                     Page 18
  1312.  
  1313.  
  1314.  
  1315.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 19
  1316.  
  1317.  
  1318.        insert  the  modem  speed,  and  \VV  to  insert  the filename.  The
  1319.        resulting macro:
  1320.  
  1321.          \DC[\P:JMODEM -DEV \MD -SPEED \MS -SEND \VV]
  1322.  
  1323.        Refer to the pre-defined  macros  and to the help screen for further
  1324.     information.  Protocol configuration is somewhat complex, but it is one
  1325.     of the features that makes BOYAN uniquely flexible.
  1326.  
  1327.  
  1328.     2.5.14  Personal Configuration Note Space
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.     Section 2.5                                                     Page 19
  1375.  
  1376.  
  1377.  
  1378.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 20
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.                                    Chapter 3
  1388.  
  1389.                           BOYAN Command Capabilities
  1390.  
  1391.  
  1392.        When BOYAN is in terminal mode, it lets you communicate  through the
  1393.     modem without obstruction.  However, at all times BOYAN's many commands
  1394.     are  one  keystroke  away.  This chapter describes in detail how to use
  1395.     the BOYAN commands.
  1396.  
  1397.  
  1398.     3.1  <Ctrl-Home> Help Menu
  1399.  
  1400.  
  1401.        While in terminal mode, pressing <Ctrl-Home> brings up a menu of all
  1402.     available BOYAN commands.  The menu is split into four sections:  Modem
  1403.     Commands, Miscellaneous, File/DOS Commands, and Toggles.  Note that the
  1404.     current ON/OFF status for each of the toggles is displayed.
  1405.  
  1406.        To  execute  a  command,  type  the  keystroke  to  the right of the
  1407.     command's description.  To view the help screen menu and gain access to
  1408.     all  of  BOYAN's  help screens, press <Ctrl-Home> again as described on
  1409.     page 8.  If you prefer to return to terminal  mode  without executing a
  1410.     command, simply press <Esc>.
  1411.  
  1412.  
  1413.     3.2  <Alt-X> Exit BOYAN
  1414.  
  1415.  
  1416.        When  you  have  finished a BOYAN session and wish to return to DOS,
  1417.     press <Alt-X>.   Press <Y> to verify the exit, or <N> to stay in BOYAN.
  1418.     If you exit while still connected through the modem, you will  be given
  1419.     a  message to that effect.  The Data Terminal Ready signal will be held
  1420.     or dropped depending on your configuration (see page 17).
  1421.  
  1422.        Be careful not to confuse this command with the <Alt-J> Jump  to Dos
  1423.     command, which lets you enter DOS but keeps BOYAN in  background memory
  1424.     (described on page 34).
  1425.  
  1426.  
  1427.     3.3  <Alt-Z> Zap (Clear) Screen
  1428.  
  1429.  
  1430.        To clear the current screen of text, press <Alt-Z>.  The status line
  1431.     will remain intact.
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.     Section 3.0                                                     Page 20
  1438.  
  1439.  
  1440.  
  1441.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 21
  1442.  
  1443.  
  1444.     3.4  <Alt-B> Beeps and Bells Toggle
  1445.  
  1446.  
  1447.        The Beeps and Bells setting is a toggle, taking the value ON or OFF.
  1448.     When BOYAN starts, it will set this toggle to  its  configured  default
  1449.     (page 9).   Note that the alarms will still sound even if the Beeps and
  1450.     Bells toggle is OFF.
  1451.  
  1452.  
  1453.     3.5  <Alt-E> Echo Keyboard Toggle
  1454.  
  1455.  
  1456.        When the Echo Keyboard Toggle is switched OFF,  every  character you
  1457.     type is sent to the modem only.  When this toggle is ON, each character
  1458.     is sent to  both  the modem and the local screen.  If you see double of
  1459.     everything  you  type, or if you can't see what you type  at  all,  try
  1460.     pressing  <Alt-E>.  BOYAN initializes this  toggle  to  its  configured
  1461.     default (page 13).
  1462.  
  1463.  
  1464.     3.6  <Shift-Tab> Add Linefeeds Toggle
  1465.  
  1466.  
  1467.        When  this  option  is ON, BOYAN  adds  linefeeds  to  all  incoming
  1468.     carriage returns; when OFF, all carriage returns are  processed  as is.
  1469.     If all text is double spaced, or if all text is overprinted on the same
  1470.     line, try pressing <Shift-Tab>.  BOYAN initializes this  toggle  to its
  1471.     configured default (page 13).
  1472.  
  1473.  
  1474.     3.7  <Alt-G> Gossip Mode Toggle
  1475.  
  1476.  
  1477.        BOYAN  provides  a  gossip  mode  for direct "chatting" to a  remote
  1478.     operator.  When gossip mode is invoked by pressing  <Alt-G>,  the  echo
  1479.     keyboard toggle is automatically  turned  ON,  and  the screen is split
  1480.     into two parts.  The upper, larger part displays  incoming  text  only,
  1481.     while  the  lower  part displays the text which you type.    All  BOYAN
  1482.     commands are still available during gossip mode.  When you  press <Alt-
  1483.     G> again to turn Gossip Mode OFF, the echo keyboard toggle  is returned
  1484.     to its previous setting.
  1485.  
  1486.  
  1487.     3.8  <Alt-A> ANSI Graphics Toggle
  1488.  
  1489.  
  1490.        Many systems can use the ANSI Graphics escape codes to  control your
  1491.     screen color and cursor positioning.  If BOYAN's  ANSI  Graphics Toggle
  1492.     is ON, these codes will be interpreted; if it is off, the codes will be
  1493.     simply displayed on the screen as they arrive.  BOYAN  initializes this
  1494.     toggle to  its  configured  default  (page  13).   NOTE: BOYAN does not
  1495.     require that you install an ANSI.SYS driver in memory.  It  handles the
  1496.     codes itself.
  1497.  
  1498.  
  1499.  
  1500.     Section 3.4                                                     Page 21
  1501.  
  1502.  
  1503.  
  1504.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 22
  1505.  
  1506.  
  1507.     3.9  <Alt-U> Use Default Text Color
  1508.  
  1509.  
  1510.        If a system sends an ANSI Graphics code that changes the text color,
  1511.     you can change it back to its configured default with this command.
  1512.  
  1513.  
  1514.     3.10  <Alt-T> Translate Table Toggle
  1515.  
  1516.  
  1517.        When this toggle is selected ON, BOYAN will translate incoming ASCII
  1518.     characters as specified in the translation table (page 17).   When OFF,
  1519.     all characters are displayed without modification.
  1520.  
  1521.  
  1522.     3.11  <Alt-S> Save Screen Image to Disk
  1523.  
  1524.  
  1525.        Press  <Alt-S>  to  save the current screen to a disk  file.    This
  1526.     file's directory and filename are configurable (page 11).  Each  time a
  1527.     screen is saved, BOYAN appends a 1-line header and the screen  image to
  1528.     the end of the file.
  1529.  
  1530.  
  1531.     3.12  <Shift-PrtSc> Save Screen Image to Printer
  1532.  
  1533.  
  1534.        As always, the <Shift-PrtSc>  command  will  copy the entire current
  1535.     screen to the printer.
  1536.  
  1537.  
  1538.     3.13  <Ctrl-PrtSc> Printer Log Toggle
  1539.  
  1540.  
  1541.        After you press <Ctrl-PrtSc> all incoming text is logged (copied) to
  1542.     the printer.  Before  printing  starts,  however,  BOYAN offers a brief
  1543.     status line menu  of  printer  options:  you  can press <I> to send the
  1544.     Initialization string which you have  configured;  <L>  to  advance the
  1545.     printer to the next line; <F> to advance the printer  to  the next form
  1546.     (page);  or  <M> to "type" a brief message to the printer.    When  the
  1547.     printer is set up properly, press <Space> for BOYAN to  start printing.
  1548.     To  stop printer logging later, press <Ctrl-PrtSc>  again.    (Page  10
  1549.     describes how to set up a printer initialization string.)
  1550.  
  1551.  
  1552.     3.14  <Alt-L> Log to Disk Toggle
  1553.  
  1554.  
  1555.        Press <Alt-L>  to  log  all  incoming text to a disk file.  You will
  1556.     have to enter the log file's name using the BOYAN Line Editor (page 8),
  1557.     or  just  hit <Return> to accept the default (page 11).   If  the  file
  1558.     exists, BOYAN will append the new text to the end of  the  file.   When
  1559.     you begin logging, or  whenever  you make a connection while logging is
  1560.  
  1561.  
  1562.  
  1563.     Section 3.10                                                    Page 22
  1564.  
  1565.  
  1566.  
  1567.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 23
  1568.  
  1569.  
  1570.     on, BOYAN adds a one-line status message to  the  log  file  giving the
  1571.     time, date, and system name.  Press <Alt-L> again to stop disk logging.
  1572.  
  1573.  
  1574.     3.15  <Alt-P> Parameter Change
  1575.  
  1576.  
  1577.        BOYAN version D3 supports 2 serial ports (Com1 and Com2), five modem
  1578.     speed rates (300,  1200,  2400,  4800,  and 9600), and 3 parity formats
  1579.     (none,  even,  and  odd).  When  BOYAN  starts,  it  sets  these  three
  1580.     variables to the defaults specified in the configure section (page 12).
  1581.     If  you  dial  a  number  from  the  dialing   directory,   BOYAN  will
  1582.     automatically set the modem parameters;  however, if you wish to change
  1583.     the parameters manually, you  may  use  the  <Alt-P> command.  Pressing
  1584.     <Alt-P> brings up a menu of key options, enabling you to  change serial
  1585.     port,  modem  speed,  or parity.  Choose from among <A>, <B>, <3>, <1>,
  1586.     <2>, <4>, <9>, <N>, <E>, and <O> until  the  Status  Line  displays the
  1587.     desired parameters.  Then press <Return> for BOYAN to make  the change.
  1588.     If  you  press  <Esc>  during  this  process  BOYAN  will return to its
  1589.     previous parameters.  After you exit the new  parameters  are displayed
  1590.     on the status line.
  1591.  
  1592.  
  1593.     3.16  <Alt-D> Dial a System
  1594.  
  1595.  
  1596.        BOYAN makes it simple  to  make  connections through an auto-dialing
  1597.     modem, either with a number entered manually or a number from  its 200-
  1598.     entry dialing directory.  Before using the <Alt-D> command to  dial, be
  1599.     sure that your  modem's  dialing commands are properly configured (page
  1600.     14).  When you press <Alt-D>,  you  are  shown the "DIAL:" prompt.  You
  1601.     may now 1) enter a full phone  number  to  dial  manually,  2)  enter a
  1602.     dialing  code  number  between  1  and  200  to dial a system from  the
  1603.     directory, or 3) press <Return> to access the dialing directory.
  1604.  
  1605.  
  1606.     3.16.1  Manual Dialing
  1607.  
  1608.  
  1609.        Automatic dialing  from the BOYAN directory has many advantages over
  1610.     manual  dialing:  BOYAN automatically sets  the  parameters,  maintains
  1611.     information  about the system, and lets you  abbreviate  with  a  short
  1612.     dialing  code  number.    Nevertheless,  manual  dialing  is  sometimes
  1613.     convenient if you wish to just  try  a system once without bothering to
  1614.     permanently change your directory.    To  dial  manually, first use the
  1615.     <Alt-P> command to be sure the modem's parameters are set to the proper
  1616.     values.  To dial, type <Alt-D>, the system's full number, and <Return>.
  1617.     What happens next is explained in the "After Dialing" section.
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.     Section 3.15                                                    Page 23
  1627.  
  1628.  
  1629.  
  1630.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 24
  1631.  
  1632.  
  1633.  
  1634.     3.16.2  Code Number Dialing
  1635.  
  1636.  
  1637.        To dial  a  system  which  has  already  been entered in the Dialing
  1638.     Directory,  simply type its code number  (1-200)  and  press  <Return>.
  1639.     BOYAN will set itself to that system's parameters and dial.
  1640.  
  1641.  
  1642.     3.16.3  After Dialing
  1643.  
  1644.  
  1645.        After BOYAN has dialed a number in either of the two  ways described
  1646.     above, it waits for 45 seconds  (to  change  this, see page 16) for the
  1647.     modem to return a message.   BOYAN  chooses one of four paths depending
  1648.     on what happens in those 45 seconds:
  1649.       1.  If you press the <Esc> key OR the modem returns an  error message
  1650.           (page 13): you are immediately returned control.
  1651.  
  1652.       2.  If  you press the <space> bar OR  the  45-second  timer  expires:
  1653.           BOYAN cycles (cancels) the current dialing attempt with the cycle
  1654.           dialing macro (page  14),  adds  or  updates  the  number  in the
  1655.           redialing queue (page 27), and then returns control to you.
  1656.  
  1657.       3.  If  the  modem  returns one of the no-connect messages (page 13):
  1658.           BOYAN  adds  or  updates  the  number in the redialing queue  and
  1659.           returns control to you.
  1660.  
  1661.       4.  If BOYAN detects carrier OR sees the connect  message  (page 13):
  1662.           you  have connected!  If its  auto-speed-detect  feature  is  on,
  1663.           BOYAN  checks   the  connect  message  and  sets  the  baud  rate
  1664.           appropriately.  It then starts an elapsed-time-of-call timer.  If
  1665.           the  number was dialed from the  directory,  an  automatic  logon
  1666.           script  file  will  take  control  if  one  was  specified.    If
  1667.           applicable, BOYAN also displays  the  last  date you connected to
  1668.           this system.  Finally, if this number was in the  redialing queue
  1669.           (page 27), it is removed.  You are then returned control.
  1670.  
  1671.        BOYAN's ability to automatically add  and  delete  numbers  from the
  1672.     redialing queue is powerful and  unique.    Instructions  for redialing
  1673.     from the queue with the <Alt-Q> command are on page 27.
  1674.  
  1675.  
  1676.     3.16.4  The Dialing Directory
  1677.  
  1678.  
  1679.        BOYAN  maintains  a  200-number  dialing  directory  for  your  most
  1680.     frequently-dialed systems.   To  access  the  directory  press <Return>
  1681.     immediately  at  the  "DIAL:"  prompt.   The directory  display  should
  1682.     appear, consisting of the directory page  number,  a chart of 20 of the
  1683.     system entries, and a brief help line.  For each entry,  BOYAN displays
  1684.     its name, phone number, logon  script file name, default protocol, baud
  1685.     rate,  parity  setting, and last connect date.    A  square  before  an
  1686.  
  1687.  
  1688.  
  1689.     Section 3.16                                                    Page 24
  1690.  
  1691.  
  1692.  
  1693.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 25
  1694.  
  1695.  
  1696.     entry's name indicates that the entry  is  in the redialing queue.  You
  1697.     then have the following options:
  1698.  
  1699.      - To dial a number manually, simply type in the full number  and press
  1700.        <Return>.  (See page 23.)
  1701.  
  1702.      - To dial one of the entries in the  phone  list,  enter  the system's
  1703.        code (1-200) and press <Return>.  (See page 23.)
  1704.  
  1705.      - <Ctrl-Home>: gives detailed help with dialing directory commands (on
  1706.        the left side of the help screen).
  1707.  
  1708.      - <Home>: view page 1 of the directory.
  1709.  
  1710.      - <End>: view page 10 of the directory.
  1711.  
  1712.      - <PgUp>, <PgDn>: page through the directory.
  1713.  
  1714.      - <E>dit: enter a new entry or  edit  an  existing entry.  You will be
  1715.        prompted to choose a code number (1-200) and press <Return>.   Then,
  1716.        using the BOYAN Line Editor (page 8), enter the system's name, phone
  1717.        number, script file name, default file transfer protocol, baud rate,
  1718.        and parity setting.  As you  are  prompted for each entry BOYAN will
  1719.        give instructions on the bottom line of the directory display.  Note
  1720.        that  if you have not written a logon script file for the entry, you
  1721.        should leave the "Script" field blank.
  1722.  
  1723.      - <L>ocate:  scan  the  dialing directory for certain entries.  At the
  1724.        "LOCATE:"  prompt, type in a part of the  desired  entry's  name  or
  1725.        phone  number,  and  press <Return>.  For example, "rbbs" will match
  1726.        "Phil's RBBS" as well as "ComputerBBS"; "381" will match all entries
  1727.        with numbers like "1-301-381-6441"  or  "730-3810".    If a match is
  1728.        found, it is highlighted on the screen.  To  continue  scanning  the
  1729.        directory for further matches, press <L> again and <Return>.
  1730.  
  1731.      - <A>lphabetize:  alphabetize  a  range of entries by  name  or  phone
  1732.        number.    Press  <A> and choose whether to sort by  entry  name  or
  1733.        number.   In numerical sorts, local  numbers  always  precede  long-
  1734.        distance numbers.  You must also specify the first and  last entries
  1735.        in  the range to be sorted.  The process may take several seconds to
  1736.        complete.
  1737.  
  1738.      - <D>elete: delete  an  entry  or  range  of  entries.  Enter the code
  1739.        numbers of the first and last entries in the range to delete.  Those
  1740.        entries and all entries  between  them  will  be replaced with blank
  1741.        entries.    To  delete only a single entry, specify its code as both
  1742.        the first and last entry.
  1743.  
  1744.      - <S>wap:  exchange  any  two entries.  This is convenient when, after
  1745.        alphabetizing  with  the  <A>  command,  you wish to put a  favorite
  1746.        system at the  top of the list.   Simply specify the code numbers of
  1747.        the two entries to swap.
  1748.  
  1749.  
  1750.  
  1751.  
  1752.     Section 3.16                                                    Page 25
  1753.  
  1754.  
  1755.  
  1756.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 26
  1757.  
  1758.  
  1759.      - <P>rint: print a nicely-formatted range of the directory.  Enter the
  1760.        code  numbers  of  the first and last entries in the range to print.
  1761.        You can set up the  printer  automatically  through  BOYAN's printer
  1762.        interface (see page 22).
  1763.  
  1764.      - <F>ile: files a nicely-formatted range  of  the  directory  to disk.
  1765.        The text file formed will be suitable for later printing, uploading,
  1766.        or  viewing.  BOYAN will request that you  enter  the  file's  name,
  1767.        using the default you specify (page 11).
  1768.  
  1769.        The directory is automatically saved to disk after  any  changes you
  1770.     make  to  it.    Be  sure  that you do not remove the  disk  containing
  1771.     BOYAN.FON at any time when within BOYAN.
  1772.  
  1773.  
  1774.     3.16.5  Long-Distance Dialing Prefixes
  1775.  
  1776.  
  1777.        Phone numbers are processed  as  macros; that is, when BOYAN dials a
  1778.     number,  it joins the modem dialing prefix,  phone  number,  and  modem
  1779.     dialing  suffix and treats the whole string as a macro.  Thus any macro
  1780.     command (see page 13 and the  appendix)  can be embedded within a phone
  1781.     number.   BOYAN's ShortCut macro commands are an example.  If you use a
  1782.     long-distance service with codes too long to fit in the directory, this
  1783.     is your solution.
  1784.  
  1785.        Suppose you belong to a  long-distance service which requires you to
  1786.     dial a local number (say 765-4321), pause, and enter a seven-digit code
  1787.     (say 1234567) before dialing  the  long-distance  number itself.  Using
  1788.     BOYAN's  configuration section, assign the \*  ShortCut  (#18)  to  the
  1789.     string  765-4321,,1234567 .   Then, wherever the backslash and asterisk
  1790.     are  found  embedded  in a phone  number,  the  above  string  will  be
  1791.     substituted.   For example, a directory entry  with  the  phone  number
  1792.     \*301-381-6441  will automatically use your long-distance  service when
  1793.     it is dialed.  All other macro commands are valid within phone numbers,
  1794.     too.
  1795.  
  1796.  
  1797.     3.16.6  Uniform Dialing Prefixes
  1798.  
  1799.  
  1800.        Another common situation is when the same BOYAN phone directory must
  1801.     be used both at home and at work.  If the work phone requires a 9 and a
  1802.     pause before dialing out  (e.g.  Centrex),  the  most convenient way to
  1803.     implement this is to change the  modem  dialing prefix itself.  This is
  1804.     done in macro #1 of configuration area "D" (page 14).
  1805.  
  1806.        Suppose you want to set it up so you can press the <F9> key whenever
  1807.     you  start BOYAN up at work, and the <F10> key whenever you start BOYAN
  1808.     up at home; thereafter BOYAN will use the correct dialing prefix.   The
  1809.     \SM1 macro command sets the dialing prefix (see the appendix).   So you
  1810.     would configure  macro  #  39  <F9> to be  \SM1[ATDT 9,]  and configure
  1811.     macro # 40 <F10> to be  \SM1[ATDT]  .   Be  sure  there  are  no spaces
  1812.     outside the square brackets when you type these macros.  This method is
  1813.  
  1814.  
  1815.     Section 3.16                                                    Page 26
  1816.  
  1817.  
  1818.  
  1819.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 27
  1820.  
  1821.  
  1822.     convenient  and  saves  many  keystrokes  over  the  methods  of  other
  1823.     communications programs.
  1824.  
  1825.  
  1826.     3.16.7  Automatic Logon Scripts
  1827.  
  1828.  
  1829.        For information on automating all your  communication  sessions, see
  1830.     the appendix (page 50).
  1831.  
  1832.  
  1833.     3.17  <Alt-Q> Queue Redialing
  1834.  
  1835.  
  1836.        BOYAN's  queue  redialer  is  one  of its easiest and most  powerful
  1837.     features.    It  will repeatedly dial from a list of busy numbers until
  1838.     one connects.  Systems  which  you have dialed with the <Alt-D> command
  1839.     without connecting are automatically added to the list, or "queue."  If
  1840.     you later dial the system with <Alt-D> again, and do make a connection,
  1841.     BOYAN  removes  the number from the queue.    Up  to  twenty  different
  1842.     systems can be in the queue at one time.
  1843.  
  1844.        Press <Alt-Q> from  BOYAN's  terminal  mode.   A list of all numbers
  1845.     currently in the queue is displayed.  BOYAN  provides  several commands
  1846.     for you  to  add  new  systems to the queue and delete systems from the
  1847.     queue:
  1848.  
  1849.      - <Ctrl-Home>:  for online help with  queue  commands.  Help is on the
  1850.        right side of the help screen.
  1851.  
  1852.      - To  add a number to the queue which is not in the dialing directory,
  1853.        simply type the full number manually and press <Return>.
  1854.  
  1855.      - To add a  number  to  the  queue  which is in the dialing directory,
  1856.        simply type the system's code (1-200) and press <Return>.
  1857.  
  1858.      - <Return>:  add  numbers  to  the  queue  directly  from  the dialing
  1859.        directory.  While in the directory, all directory commands including
  1860.        alphabetizing, printing, etc.  are  valid  (see  page 24).  To add a
  1861.        number to the queue while viewing the dialing directory, simply type
  1862.        the full number manually  or  the  directory  code (1-200) and press
  1863.        <Return>.  You will remain in the dialing directory until  you press
  1864.        <Esc> to go back to the queue display.  Entries  added  to the queue
  1865.        will have small squares before their names.
  1866.  
  1867.      - <D>elete:  delete any system from  the  queue.   Letters from A to T
  1868.        will  appear  on  the  left-hand  side  of  the  screen next to each
  1869.        system's  name.  Press the letter next to the name of the system you
  1870.        wish to delete.
  1871.  
  1872.      - <C>lear:  clear  the  entire  queue.    You will have to verify your
  1873.        decision by pressing <Y>.
  1874.  
  1875.  
  1876.  
  1877.  
  1878.     Section 3.16                                                    Page 27
  1879.  
  1880.  
  1881.  
  1882.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 28
  1883.  
  1884.  
  1885.      - <Space>:  BEGIN REDIALING.  Starting  with  the number at the top of
  1886.        the queue, BOYAN will dial each number in turn,  waiting  for  modem
  1887.        messages just as  after  dialing  with  <Alt-D>  (page  24).   After
  1888.        dialing the last number in the queue, it returns to  the  top to try
  1889.        the whole list again.  After every unsuccessful  redial,  BOYAN will
  1890.        run macro # 6 (see page 15) and then pause  for  a configured number
  1891.        of seconds.  During this pause, pressing <Esc>  will  stop redialing
  1892.        and  return to the queue display,  pressing  <space>  will  manually
  1893.        cycle BOYAN to the next number  in  the queue, and pressing <D> will
  1894.        delete  the  number  just  dialed  from  the  queue.   The number of
  1895.        attempts and current status for each system is always displayed.
  1896.  
  1897.        When BOYAN  detects  a  connection  with  one  of the systems it has
  1898.     dialed, the redialing screen will disappear and a loud alarm will sound
  1899.     (the volume may be changed; see page 10).  Press any  key  to  stop the
  1900.     alarm.  At  that  point,  BOYAN  will execute the auto-logon script (if
  1901.     any) and update the last connect date for  systems  which  were  in the
  1902.     dialing  directory.    This system is automatically  deleted  from  the
  1903.     queue, so after  you  have  finished  with your successful call you may
  1904.     press <Alt-Q><Space> to dial from the remaining systems.
  1905.  
  1906.        Of course, press <Esc> to exit the queue.
  1907.  
  1908.  
  1909.     3.18  <Alt-H> Hang Up Modem
  1910.  
  1911.  
  1912.        Press <Alt-H> to hang up the modem.   BOYAN  will  first  attempt to
  1913.     hang up  by  dropping  the  DTR signal for one second.  For most modems
  1914.     this will work instantly.  If there is still a carrier,  however, BOYAN
  1915.     executes the hangup macro (#4).  See page 14 for more information.
  1916.  
  1917.  
  1918.     3.19  <Ctrl-End> Send Modem Break Signal
  1919.  
  1920.  
  1921.        Some mainframe systems recognize  a  special  signal called a "modem
  1922.     break."  Press <Ctrl-End> to send this signal.
  1923.  
  1924.  
  1925.     3.20  BOYAN File Transfers
  1926.  
  1927.  
  1928.        One  of  the  most  frequent  activities  during   communication  is
  1929.     transferring files.  Sending a file from your PC to the remote computer
  1930.     is  called  uploading;  receiving  a  file from the remote computer  is
  1931.     downloading.  It is possible to  transfer  a file by simply sending its
  1932.     contents directly, but sometimes phone  line  "noise"  can  cause fatal
  1933.     errors  during the transfer.  Various  "protocols"  were  developed  to
  1934.     check for, and correct, those errors.  BOYAN version  D3  supports  the
  1935.     following file transfer protocols internally:
  1936.  
  1937.     Xmodem           Very   widely  used;  good  error-checking  with   the
  1938.                      checksum method.
  1939.  
  1940.  
  1941.     Section 3.17                                                    Page 28
  1942.  
  1943.  
  1944.  
  1945.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 29
  1946.  
  1947.  
  1948.     Relaxed Xmodem   Identical to  Xmodem,  but  with  relaxed  timing  for
  1949.                      networks such as CompuServe.
  1950.  
  1951.     CRC-Xmodem       An enhancement to Xmodem that slows  it  down slightly
  1952.                      but vastly  improves  error-checking  with  the Cyclic
  1953.                      Redundancy Check method.
  1954.  
  1955.     Ymodem           This is an extremely fast protocol over  "clean" phone
  1956.                      lines, but very slow if there  is  a lot of noise.  It
  1957.                      will automatically convert to CRC-Xmodem in mid-upload
  1958.                      if there are too many errors.
  1959.  
  1960.     G-option Ymodem  This is a variant of  Ymodem  specially  developed for
  1961.                      sophisticated, high speed modems with their own built-
  1962.                      in error-checking protocols.
  1963.  
  1964.     ASCII            This is the fastest protocol of all, but  there  is NO
  1965.                      error-checking.   It may only be used with text files.
  1966.                      Generally,   if  the  accuracy  of  the  transfer   is
  1967.                      important, this method should not be used.
  1968.  
  1969.     Message Upload   This is a  "smart"  ASCII variant that BOYAN uses only
  1970.                      for uploading messages.    You can save time and money
  1971.                      by preparing messages with your word processor instead
  1972.                      of typing on-line.  See page 30 for details.
  1973.  
  1974.        With certain additional files in the BOYAN directory, BOYAN can also
  1975.     support Kermit, Zmodem, Sealink, Megalink, and any other  method  as an
  1976.     external  protocol  (see  page 31).   BOYAN's  help  screen  "M"  gives
  1977.     detailed information about file transfer procedures and protocols.
  1978.  
  1979.  
  1980.     3.20.1  Auto-Find Filename Feature
  1981.  
  1982.  
  1983.        BOYAN  has  the  unique  feature  of  being  able  to  automatically
  1984.     determine the name of the file you wish to transfer  based  on what you
  1985.     have told the remote computer.  All other known communications programs
  1986.     require  you  to  type the full filename twice.  This  feature  may  be
  1987.     disabled if you desire (page 12).
  1988.  
  1989.  
  1990.     3.20.2  <PgUp> Upload File
  1991.  
  1992.  
  1993.        This is the procedure you should follow for uploading  a  file  from
  1994.     your PC to a remote system:
  1995.       1.  With BOYAN's terminal mode, tell  the remote system that you wish
  1996.           to upload a file.  As it prompts, enter the  file's  name and the
  1997.           upload protocol you wish to use.
  1998.  
  1999.       2.  When the remote  system  says  it  is ready to receive, press the
  2000.           <PgUp>  key.    (Alternatively, you may select  straight  from  a
  2001.           directory list with the <Del> key; see page 32.)
  2002.  
  2003.  
  2004.     Section 3.20                                                    Page 29
  2005.  
  2006.  
  2007.  
  2008.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 30
  2009.  
  2010.  
  2011.       3.  From the menu of protocols, press the letter corresponding to the
  2012.           same protocol you told the remote system you would use.  Pressing
  2013.           <Return> instead accepts the default protocol (page 11).
  2014.  
  2015.       4.  In  its  upload  window BOYAN will display the directory path and
  2016.           filename  of the file to be transferred.  If the file you wish to
  2017.           upload  is  not  in the path displayed, press the <Up-Arrow> key,
  2018.           edit the pathname, and press <Return>.  Make sure the filename is
  2019.           correct and press <Return>.  The transfer should begin.
  2020.  
  2021.       5.  To abort the upload procedure at any time, press <Esc>.
  2022.  
  2023.       6.  When the transfer finishes, successfully or unsuccessfully, BOYAN
  2024.           will sound the  alarm  (see  page  12) and return you to terminal
  2025.           mode.    The  transfer  time  will  be  displayed for  successful
  2026.           uploads.
  2027.  
  2028.  
  2029.     3.20.3  Uploading a Message
  2030.  
  2031.  
  2032.        If you write a  message  using your word processor, SideKick, or any
  2033.     other ASCII text editor, BOYAN is well-equipped to upload it just as if
  2034.     you had typed the message directly.  First, from  terminal  mode,  tell
  2035.     the  remote  system  you  wish  to  enter  a  message; enter all header
  2036.     information such as  receiver,  subject,  etc.   When you are given the
  2037.     prompt  for  the  first  line  of  the  message,  press <PgUp>.  Select
  2038.     <M>essage Upload as the protocol.  You will have to enter the message's
  2039.     filename manually.
  2040.  
  2041.        BOYAN  provides a degree of convenience  in  message  uploading  not
  2042.     found in any other communications  program.    First,  it automatically
  2043.     determines the remote  system's  line prompt; press <Return> to verify.
  2044.     Then watch as BOYAN "types" the  message.   It will automatically add a
  2045.     space to any blank lines because most systems interpret a blank line as
  2046.     the  end-of-message  signal.   If you have turned the "Auto-Detect Word
  2047.     Wrap" feature on, it will  automatically  detect  an  incoming <Return>
  2048.     character and assume that  the  remote  system  has "word-wrapped."  In
  2049.     that case, BOYAN will send the line WITHOUT a <Return> character.  This
  2050.     feature means that you do not need to tailor your prepared  messages to
  2051.     the system's maximum line length;  if the system word-wraps, BOYAN will
  2052.     take care of it for you.  Graphic messages with boxes and the like will
  2053.     not  work well with this feature if they  exceed  the  remote  system's
  2054.     maximum line length.  (See page 12.)
  2055.  
  2056.  
  2057.     3.20.4  <PgDn> Download File
  2058.  
  2059.  
  2060.        To download a file, do the following:
  2061.       1.  From BOYAN's terminal  mode,  instruct the remote system that you
  2062.           wish  to  download  a file.  As it prompts, enter the file's name
  2063.           and the download protocol you wish to use.
  2064.  
  2065.  
  2066.  
  2067.     Section 3.20                                                    Page 30
  2068.  
  2069.  
  2070.  
  2071.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 31
  2072.  
  2073.  
  2074.       2.  When the remote system says it is ready to send, press <PgDn>.
  2075.  
  2076.       3.  From  the  protocol  menu,  select  the first letter of the  same
  2077.           protocol  you told the remote system you  would  use.    Pressing
  2078.           <Return> instead accepts the default protocol (page 11).
  2079.  
  2080.       4.  In its download window  BOYAN  will  display the default transfer
  2081.           directory pathname  and  the  filename  it  found  automatically.
  2082.           Press  <UpArrow> if you wish to  change  the  drive/directory  to
  2083.           which  the  file  is  saved.   Press <Return> at the  "FILENAME:"
  2084.           prompt when all  information  is  correct.   If you are using the
  2085.           ASCII protocol, you may have to press <Return> again to signal to
  2086.           the remote system that you are ready.  The transfer will begin.
  2087.  
  2088.       5.  Press <Esc> at any time to abort the download.
  2089.  
  2090.       6.  When the transfer finishes, BOYAN  will sound its alarm (see page
  2091.           12).  If the transfer was successful, the   total  transfer  time
  2092.           and transfer efficiency will also  be  displayed.    The transfer
  2093.           efficiency is based on a pure transmission at full speed,  so any
  2094.           figure above 75% is quite good.
  2095.  
  2096.        You  will  find  that BOYAN's transfers almost always take less time
  2097.     than the remote system predicts they will.
  2098.  
  2099.  
  2100.     3.20.5  External Protocol Transfers
  2101.  
  2102.  
  2103.        Many sophisticated protocols  are supported by standardized programs
  2104.     on  the  IBM-PC.   Jan van der Eijk's PCKERMIT.EXE, for example, is the
  2105.     standard  for  the  Kermit  protocol,   widely   used   on  mainframes.
  2106.     Analogously, Chuck Forsberg's DSZ.EXE is  the  standard  for  Zmodem, a
  2107.     sleek new protocol.  BOYAN uses standard programs like these to perform
  2108.     so-called "external  protocol transfers."  Any external protocol can be
  2109.     configured to run through BOYAN (see page 18).
  2110.  
  2111.        BOYAN  is  preconfigured  for  Kermit,  Zmodem,  Sealink  (CLINK.EXE
  2112.     needed),  and  Megalink  (MLINK.COM  needed).    To  use any  of  these
  2113.     protocols, place the external program in the BOYAN  directory.   (These
  2114.     files are available on  many  IBM-PC  bulletin board systems, including
  2115.     the  BOYAN  Support  BBS.)  Be sure that you have configured enough DOS
  2116.     Shell Space for the external protocols to run;  DSZ-Zmodem  may require
  2117.     up to 105 K, although most others will run under 64 K.  BOYAN will then
  2118.     automatically make the protocol  available  on  its  menus.  Note: with
  2119.     Kermit,  Zmodem,  and  Megalink,   so-called   "Batch   Transfers"  are
  2120.     permitted; that is, you  can  specify a wildcard filename like  BOYAN.*
  2121.     to be transferred, and all matching files will be sent.
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.     Section 3.20                                                    Page 31
  2131.  
  2132.  
  2133.  
  2134.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 32
  2135.  
  2136.  
  2137.     3.21  The BOYAN.USE "Usage Log" File
  2138.  
  2139.  
  2140.        BOYAN can be set to automatically maintain a log of activity  in the
  2141.     BOYAN home directory called  BOYAN.USE.    This file will automatically
  2142.     note the date,  time,  and  length  of all system connections made with
  2143.     BOYAN.  In addition, all file transfers are recorded in the  file along
  2144.     with the name  of  the  protocol  used  and  the  transfer's efficiency
  2145.     percentage.  A blank line is added to the file each time BOYAN is run.
  2146.  
  2147.        You may configure a default for whether or not to maintain this file
  2148.     (see page 11).  The \UF+ and \UF- macro commands may  also  be  used to
  2149.     turn the file on and off.  Also, the \UM[string] macro command lets you
  2150.     manually add any entry to the usage log.
  2151.  
  2152.  
  2153.     3.22  <Del> Directory File Manager
  2154.  
  2155.  
  2156.        BOYAN  houses a complete integrated file manager.    To  invoke  it,
  2157.     press  <Del>  from  terminal  mode.    At  the  "DIR" prompt, enter any
  2158.     drive/path/file specifier just as you would with the  DOS  DIR command;
  2159.     or, just press <Return> for all  files  in the current directory.  Both
  2160.     "?" and "*"  wildcards  are  supported.    BOYAN will read and sort the
  2161.     files  found, and display as many of them as it can on one screen  (105
  2162.     files).    The  free  disk  space  is  displayed on the Status Line  if
  2163.     requested  in configuration (see page 11).  BOYAN  handles  up  to  420
  2164.     files in each subdirectory.
  2165.  
  2166.        You will see  a  list  of  available  options near the bottom of the
  2167.     screen.  The <D>elete, <R>ename, <C>opy, <V>iew, and <E>xecute commands
  2168.     are only  valid  if  there  is enough memory for a DOS shell (page 10).
  2169.     Select from among the following commands:
  2170.  
  2171.      - <Ctrl-Home>  - View help screen
  2172.  
  2173.      - cursor  keys  - Use the four arrow keys to move the highlighted file
  2174.        marker from file to file.   Press  <Home>  to go to the beginning of
  2175.        the  directory, and <End> to go to the end.  If there are more  than
  2176.        105 files in the directory, press <PgUp> and <PgDn> to change pages.
  2177.        Finally, use the <Ctrl-PgUp>  and  <Ctrl-PgDn>  key  combinations to
  2178.        move to the top and bottom, respectively, of the current column.
  2179.  
  2180.      - <N>ew directory:  When you press <N> you will be  given  a new "DIR"
  2181.        prompt so you can change drives, directories, or file specifiers.
  2182.  
  2183.      - <U>pload:  Pressing <U> immediately  opens the Upload Window for the
  2184.        highlighted file so you can select a protocol and  upload  the  file
  2185.        (see page 29).
  2186.  
  2187.      - <I>nfo about file size:  Pressing <I> gives the size of  the current
  2188.        file  in bytes, and the length of time it would take to transfer the
  2189.        file at the current baud rate.
  2190.  
  2191.  
  2192.  
  2193.     Section 3.21                                                    Page 32
  2194.  
  2195.  
  2196.  
  2197.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 33
  2198.  
  2199.  
  2200.      - <F>ree  space:  press <F> to display the amount of free space on the
  2201.        drive.
  2202.  
  2203.      - <E>xecute script:  Press <E> to  execute  a BOYAN script file with a
  2204.        suffix of .BSC.  (See the appendix for script information.)
  2205.  
  2206.      - <E>xecute file:  To execute the .EXE or .COM file under  the cursor,
  2207.        press <E>.  You may add  any  command  line parameters to the end of
  2208.        the filename before pressing <Return>.
  2209.  
  2210.      - <V>iew:   Press <V> to view the file using the TYPE command or other
  2211.        command which you have substituted (page 10).  For this  command and
  2212.        all following commands, press  <Return>  when  the Status Line shows
  2213.        exactly what should be sent to DOS.
  2214.  
  2215.      - <C>opy:   Press <C> to copy the file.  Type the target for the  copy
  2216.        and press <Return>.  Note: you may print any file  by  copying it to
  2217.        the file PRN: .
  2218.  
  2219.      - <D>elete:    To  delete  the  file,  press  <D>.  As with any  other
  2220.        command, press <Esc> to abort or <Return> to accept.
  2221.  
  2222.      - <R>ename:  Press <R> to rename  the  file.  After pressing <R>, type
  2223.        the new name for the file and press <Return>.
  2224.  
  2225.      - <Esc>:  As always, to go back to terminal mode, press <Esc>.
  2226.  
  2227.  
  2228.     3.23  <Alt-F> Free Space on Disk
  2229.  
  2230.  
  2231.        Pressing  <Alt-F> displays the current drive's  free  space  on  the
  2232.     Status Line.
  2233.  
  2234.  
  2235.     3.24  <Alt-I> Information About a File's Size
  2236.  
  2237.  
  2238.        To see how large a file is and how long it  will  take  to transfer,
  2239.     press <Alt-I>.  You will be prompted to enter the path and filename.
  2240.  
  2241.  
  2242.     3.25  <Alt-N> New Default Drive/Directory
  2243.  
  2244.  
  2245.        To change the current  logged  drive  or subdirectory, press <Alt-N>
  2246.     and enter the new path.  Valid examples are  B:  ,  \MODEM\FILES  , and
  2247.     c:\utility .
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.     Section 3.22                                                    Page 33
  2257.  
  2258.  
  2259.  
  2260.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 34
  2261.  
  2262.  
  2263.     3.26  <Ins> Issue DOS Command
  2264.  
  2265.  
  2266.        If  you  have  reserved enough memory for a DOS shell (see page 10),
  2267.     pressing <Ins> will bring up the ">" prompt.  Type  any  DOS command or
  2268.     program name and BOYAN will attempt to execute it.
  2269.  
  2270.  
  2271.     3.27  <Alt-J> Jump to DOS
  2272.  
  2273.  
  2274.        This is an extremely powerful command.  If you have  reserved enough
  2275.     memory  for  a DOS shell (page 10),  pressing  <Alt-J>  will  jump  you
  2276.     directly into DOS.    From  DOS,  you  may use your word processor, un-
  2277.     ARChive  a file, or run your spreadsheet.  When you are ready to return
  2278.     to  BOYAN,  be  SURE the BOYAN disk is in the same drive it had been in
  2279.     before the shell, and type EXIT at the DOS prompt.    BOYAN will return
  2280.     to your communication session as if you had never left it.
  2281.  
  2282.  
  2283.     3.28  <Alt-V> View File
  2284.  
  2285.  
  2286.        To view the contents of an ASCII file, use this  command.   The view
  2287.     command you have configured  (page  10) plus the filename you type will
  2288.     be shelled to DOS.
  2289.  
  2290.  
  2291.     3.29  <Up-Arrow> Scroll-Back Buffer
  2292.  
  2293.  
  2294.        BOYAN's Scroll-Back buffer is  unique.    After reserving memory for
  2295.     its own variables and the DOS Shell (page 10), all remaining  memory is
  2296.     occupied by the Scroll-Back Buffer.  The buffer traps all incoming text
  2297.     from  the  modem and "remembers" it so you can scan it  later.    BOYAN
  2298.     often can save thousands of lines of past text.
  2299.  
  2300.        Press the <Up-Arrow> key  to  invoke  the  Scroll-Back Buffer.  Your
  2301.     "current position"  is  at  the  bottom of the screen.  A number in the
  2302.     top-right  corner tells you which line of the buffer you are on.  There
  2303.     are now many options available to you:
  2304.  
  2305.      - <Ctrl-Home>:  detailed help.
  2306.  
  2307.      - <Up-Arrow>, <Down-Arrow>:  scroll line-by-line through the buffer.
  2308.  
  2309.      - <PgUp>, <PgDn>:  scroll page-by-page through the buffer.
  2310.  
  2311.      - <End>:   move to the end of the buffer, which shows your most recent
  2312.        communication.    Press  <End>,  then  <PgDn> to see the first  page
  2313.        (oldest text) in the buffer.
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.     Section 3.27                                                    Page 34
  2320.  
  2321.  
  2322.  
  2323.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 35
  2324.  
  2325.  
  2326.      - <Home>:    scroll  back  to  the beginning of your last  connection.
  2327.        Every time you make a connection, BOYAN places  an  invisible marker
  2328.        in the buffer.  <Home> takes you to each of these markers in turn.
  2329.  
  2330.      - <L>ocate:  search for text within the buffer.  You will  be prompted
  2331.        for a string to locate.  BOYAN's locate routine is case-insensitive,
  2332.        so "bOyAn" will match "BoYaN".   If  the string is found, the buffer
  2333.        scrolls so the string is on the bottom line of the buffer.  The line
  2334.        is highlighted.  To search back further in the  buffer  for  further
  2335.        occurrences of the same string, press <L>, then <Return>.
  2336.  
  2337.      - <S>creen  save:    save the current page of the buffer to the screen
  2338.        dump file.  This works exactly the same as the <Alt-S> command (page
  2339.        22).
  2340.  
  2341.      - <M>ark:    To  use  the  scroll-back buffer's Print Region and  File
  2342.        Region commands, you must  first  mark  the  beginning of the region
  2343.        with the <M> command.  Use the cursor keys to move the first line of
  2344.        the desired region to the BOTTOM line of  the  screen.    Then press
  2345.        <M>.  The mark is set and the line is highlighted.
  2346.  
  2347.      - <G>o  to mark:  pressing <G> places the marked line at the bottom of
  2348.        the screen.
  2349.  
  2350.      - <P>rint:  When you want to print a region of text, the first line of
  2351.        the  region  must  already  have  been marked with the <M>  command.
  2352.        Then, use the cursor keys to  place  the  last line of the region at
  2353.        the bottom of the screen.When you press <P>, you will be able to set
  2354.        up the printer automatically  with  BOYAN's  printer  interface (see
  2355.        page 22, and then the region will be printed.
  2356.  
  2357.      - <F>ile:   To file a region of text to disk, first mark the beginning
  2358.        of the region with the <M>  command.    Use the cursor keys to place
  2359.        the  last line of the region at the bottom of the screen.  When  you
  2360.        press  <F>,  you will be prompted to  enter  a  filename  (or  press
  2361.        <Return> to use the default; page 11).  The region will be filed.
  2362.  
  2363.      - <Esc>:  exit the Scroll-Back Buffer and return to terminal mode.
  2364.  
  2365.  
  2366.     3.30  <Alt-M> Enter Macro Manually
  2367.  
  2368.  
  2369.        After pressing <Alt-M> you will be prompted, "MAC:".    Whatever you
  2370.     enter will be instantly processed as  a  macro.  Over 100 special macro
  2371.     commands are available; see the appendix for details.
  2372.  
  2373.  
  2374.     3.31  <Alt-R> Run Block from Script File
  2375.  
  2376.  
  2377.        Almost any action BOYAN does can be automated with the use  of BOYAN
  2378.     Script Files.  A BOYAN Script File is a series of  macros  stored  in a
  2379.     normal ASCII file.  This file may be  broken  into  series  of "blocks"
  2380.  
  2381.  
  2382.     Section 3.29                                                    Page 35
  2383.  
  2384.  
  2385.  
  2386.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 36
  2387.  
  2388.  
  2389.     which perform specific tasks.  The  blocks  can call each other or even
  2390.     themselves, so BOYAN's script files  are  both  modular  and recursive.
  2391.     The full description of BOYAN's script language, along with appropriate
  2392.     examples, is in the appendix.
  2393.  
  2394.        When  you  press  <Alt-R>, you are prompted to enter the name of the
  2395.     script file and the block (if any)  to  run.    The  script  file takes
  2396.     control, replacing the  BOYAN v.D3  message on the status line with its
  2397.     name.  While the script file controls BOYAN, all keyboard  commands are
  2398.     invalid except for <Esc> -- abort script.
  2399.  
  2400.  
  2401.     3.32  BOYAN's Backspace Editor
  2402.  
  2403.  
  2404.        Often, when  you  are  typing  in a line of a message, you notice an
  2405.     error  in  the  beginning  of  the  line.    Correcting this with other
  2406.     communication programs involves backspacing all the way past the error,
  2407.     then retyping the entire line the way it was.   Although  you may still
  2408.     use this  method  if  you  like, BOYAN provides a much easier way.  The
  2409.     following commands are effective whenever you are in terminal mode:
  2410.  
  2411.  
  2412.     3.32.1  <Backspace> Erase Previous Character
  2413.  
  2414.  
  2415.        As usual, the <backspace> key erases the previous  character  on the
  2416.     screen.  BOYAN automatically stores this character in memory.
  2417.  
  2418.  
  2419.     3.32.2  <LeftArrow> Erase Previous Character
  2420.  
  2421.  
  2422.        Pressing the <LeftArrow> key  while  in  terminal  mode also sends a
  2423.     backspace signal over  the  modem.    However, BOYAN does not store the
  2424.     character in memory.  See the section on using the Backspace Editor for
  2425.     the application of this command.
  2426.  
  2427.  
  2428.     3.32.3  <Ctrl-Backspace> Erase Previous Word
  2429.  
  2430.  
  2431.        To erase the previous word typed  on  the current line, at any time,
  2432.     press <Ctrl-Backspace>.   BOYAN simply sends backspace signals over the
  2433.     modem until it reaches a space.  The erased word  is  stored in BOYAN's
  2434.     memory.
  2435.  
  2436.  
  2437.     3.32.4  <Ctrl-LeftArrow> Erase Previous Word
  2438.  
  2439.  
  2440.        The <Ctrl-LeftArrow> command also sends backspace  signals  to erase
  2441.     the previous word.  BOYAN does not store the word in memory.
  2442.  
  2443.  
  2444.  
  2445.     Section 3.31                                                    Page 36
  2446.  
  2447.  
  2448.  
  2449.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 37
  2450.  
  2451.  
  2452.  
  2453.     3.32.5  <RightArrow> Un-erase Character
  2454.  
  2455.  
  2456.        Press <RightArrow> to recall the  most  recent  character  stored in
  2457.     BOYAN's backspace memory.  In  other words, the <RightArrow> key undoes
  2458.     the effect of the <Backspace> or <Ctrl-Backspace> commands.
  2459.  
  2460.  
  2461.     3.32.6  <Ctrl-RightArrow> Un-erase Word
  2462.  
  2463.  
  2464.        Press   <Ctrl-RightArrow>  to  recall  all  characters  in   BOYAN's
  2465.     backspace memory up to a space.  This command also undoes the effect of
  2466.     the <BackSpace> and <Ctrl-Backspace> commands.
  2467.  
  2468.  
  2469.     3.32.7  Using the Backspace Editor
  2470.  
  2471.  
  2472.        Suppose you have typed the following line to the modem:
  2473.  
  2474.          I have used the BOYA Communications program _
  2475.  
  2476.     (Your cursor is where the  _  is.)  You then realize that you  left out
  2477.     the  N  in BOYAN.    To  fix  it  with  the  Backspace  Editor, use any
  2478.     combination  of  the   <Backspace>  and  <Ctrl-Backspace>  commands  to
  2479.     position  the  cursor  on the space where you want the  N .  Press <N>.
  2480.     The line should read:
  2481.  
  2482.          I have used the BOYAN_
  2483.  
  2484.     Now use the <RightArrow> and  <Ctrl-RightArrow> commands as you wish to
  2485.     recall the erased part of the line.
  2486.  
  2487.        Suppose you wish to change the "I have used" phrase to "I use".  Use
  2488.     the <Ctrl-Backspace> and <Backspace> commands to position the cursor to
  2489.     the  right  of the "d" in "used."  Then press the  <LeftArrow>  key  to
  2490.     backspace  over  the  "d."    The  <LeftArrow>  key backspaces  without
  2491.     remembering the  erased character.  Press <Ctrl-Backspace> to back past
  2492.     the word "use," then press  <Ctrl-LeftArrow> to delete the word "have."
  2493.     Finally, use the <RightArrow> and  <Ctrl-RightArrow>  commands  to pull
  2494.     back the rest of the line:
  2495.  
  2496.          I use the BOYAN Communications program _
  2497.  
  2498.     Once  you get used to the Backspace Editor you will find that you never
  2499.     post messages with typos again!
  2500.  
  2501.  
  2502.     3.33  Common Questions and Answers
  2503.  
  2504.  
  2505.     Q. "Why did you write BOYAN?"
  2506.  
  2507.  
  2508.     Section 3.32                                                    Page 37
  2509.  
  2510.  
  2511.  
  2512.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 38
  2513.  
  2514.  
  2515.     A.  For  two  reasons: first, because  I  wanted  many  features  in  a
  2516.     communications  program  that  simply  aren't  available  in  the other
  2517.     programs; and second, because I really need money for college.
  2518.  
  2519.        Q. "Why doesn't BOYAN dial my modem properly?"
  2520.     A. BOYAN comes preset for Hayes-style modems that dial using the   ATDT
  2521.     command.  If you have a Hayes but wish to use pulse dialing rather than
  2522.     touch-tone, change this command to   ATDP  .   To set BOYAN for another
  2523.     kind of  modem,  consult  your  modem's  manual  and set the options in
  2524.     configure area D properly.
  2525.  
  2526.        Q.  "BOYAN says 'dial despite carrier' every time  I  dial,  and  it
  2527.     always thinks it's connected.  Why?"
  2528.     A. BOYAN depends on your modem  to  give accurate carrier status in the
  2529.     "modem  status  register."   You may have to flick a toggle switch (USR
  2530.     Courier) or type a modem command (Hayes, page 15) to  get  this to work
  2531.     properly.  If carrier detection is still wrong, then try  resetting the
  2532.     "Carrier Detect Mask" in configuration section K (see page 17).  Please
  2533.     call or write me if all else fails.
  2534.  
  2535.        Q. "How does BOYAN determine the  number  of data bits and stop bits
  2536.     to use when communicating?"
  2537.     A. BOYAN automatically uses 8 data bits whenever you select  no parity,
  2538.     and  7  data  bits with even or odd parity.  1 stop bit is always used.
  2539.     These settings should work for any connection.
  2540.  
  2541.        Q. "My modem is attached to comm port # 3.  Can I use BOYAN?"
  2542.     A. BOYAN version D3 only supports the standard ports,  Com1  and  Com2.
  2543.     Com3 and Com4 support will likely be added in a future version.
  2544.  
  2545.        Q. "BOYAN reports that it doesn't have enough memory to Jump  to Dos
  2546.     and/or use the scroll-back buffer.  How come?"
  2547.     A. BOYAN divides all available system RAM between the memory needed for
  2548.     the DOS Shell and the memory used to store scroll-back  lines.   If you
  2549.     have 192K or  less, you may not have enough memory to use both of these
  2550.     features.   To change the way BOYAN partitions  your  memory,  use  the
  2551.     configure section (see page 10).
  2552.  
  2553.        Q. "Does BOYAN have a Host Mode or terminal emulations?"
  2554.     A. A complete Host Mode for BOYAN is due to be released in Summer 1987.
  2555.     It will be  written  entirely  in  BOYAN's  Script  Language,  and thus
  2556.     entirely customizable.  As for the emulations, I will be adding as many
  2557.     as are practical once I have the specifications.  VT100 emulation is in
  2558.     the works.
  2559.  
  2560.        Q. "What if  I like BOYAN but need specific changes?  Can I have the
  2561.     welcome screen customized for my corporation?"
  2562.     A. Although BOYAN's source code is not available, I will gladly  try to
  2563.     incorporate specific changes for unordinary communications needs.
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.     Section 3.33                                                    Page 38
  2572.  
  2573.  
  2574.  
  2575.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 39
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.                                   Appendix A
  2585.  
  2586.                          Automating BOYAN's Operation
  2587.  
  2588.  
  2589.     A.1  Introduction
  2590.  
  2591.  
  2592.        The following scenario  is  made possible by BOYAN's versatile macro
  2593.     command language:
  2594.  
  2595.          You turn your computer  on  and go to bed.  Your AUTOEXEC.BAT
  2596.          file stirs BOYAN to life.  BOYAN waits until 2:45  A.M., then
  2597.          starts  dialing from a list of  your  ten  favorite  bulletin
  2598.          board systems.  It connects to one, recognizes  which  it is,
  2599.          and logs on by sending  the proper passwords when prompted by
  2600.          the  system.    BOYAN  sends  the  command  to read  all  new
  2601.          messages;  these  messages  are saved to a disk file, and all
  2602.          messages addressed to  you  are also printed on your printer.
  2603.          When all messages have been read, BOYAN  Zmodem-downloads the
  2604.          TWIDDLE.ARC  file you wanted, sends a  nice  message  to  the
  2605.          Sysop, and logs  off.    BOYAN  uses DOS to extract all files
  2606.          from the TWIDDLE ARChive.  It then continues dialing from the
  2607.          remaining  nine numbers, performing similar logons with  each
  2608.          one.  After the  clock  strikes 7:00, BOYAN will not dial any
  2609.          more  numbers,  although  the currently-connected system will
  2610.          complete normally.    Finally,  BOYAN  exits  itself  and the
  2611.          AUTOEXEC.BAT file continues.
  2612.  
  2613.  
  2614.     A.2  Overview
  2615.  
  2616.  
  2617.        At the core of  BOYAN's  operation is a "macro processor" that reads
  2618.     in  a  line  of instructions called a macro, and takes  action  on  it.
  2619.     Internally, modules of BOYAN like dialing and message uploading use the
  2620.     macro  processor.    BOYAN's command language provides  a  direct  link
  2621.     between you and the macro processor.
  2622.  
  2623.        In the configure section, there are 70 user-definable  macros.   Ten
  2624.     of them, the "modem-specific macros," are used internally by BOYAN; the
  2625.     other 60 are assigned to specific key combinations.  This appendix will
  2626.     show  how you can configure all 70 of these to work powerfully for your
  2627.     particular needs.
  2628.  
  2629.        A text file  consisting  of  many  macros is called a "script file."
  2630.     BOYAN provides the ability to section off "blocks" of macros within the
  2631.     script file, and to run them separately.  Blocks  can  reference  other
  2632.  
  2633.  
  2634.     Section A.0                                                     Page 39
  2635.  
  2636.  
  2637.  
  2638.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 40
  2639.  
  2640.  
  2641.     blocks,  other  script  files and even the  70  user-definable  macros.
  2642.     BOYAN's script language is thus completely modular and recursive.
  2643.  
  2644.  
  2645.     A.3  The Macro/Script Command Set
  2646.  
  2647.  
  2648.        Most  macro/script  commands  consist  of  a   backslash   plus  two
  2649.     characters;  many  require   further  information  enclosed  in  square
  2650.     brackets.   For  example,  \di[381-6441]    is  the command to dial the
  2651.     specified number.  The next several sections detail  the  many commands
  2652.     you can use to automate BOYAN.  Examples are given for each command.
  2653.  
  2654.  
  2655.     A.4  Definitions
  2656.  
  2657.  
  2658.        In the command format descriptions,  the  following  definitions are
  2659.     used:
  2660.  
  2661.     c                represents a single character, like  Y
  2662.  
  2663.     ##               represents an integer number, like  12
  2664.  
  2665.     string           represents a string  of  characters which is not to be
  2666.                      processed as a macro, like  WELCOME!
  2667.  
  2668.     filename         represents a full filename specifier, from TWIDDLE.ARC
  2669.                      to c:\modem\files\boyan-c1.doc
  2670.  
  2671.     macro            represents an executable macro, like  \DI[381-6441]
  2672.  
  2673.     label            represents a string which names  a  block,  where only
  2674.                      the first five characters are significant
  2675.  
  2676.        Each command  will  be  presented  with  its  format on the left, an
  2677.     example on the right, and a description following.
  2678.  
  2679.  
  2680.     A.5  Basic Commands
  2681.  
  2682.  
  2683.        The basic  macro  commands  for  sending  a  string to the modem and
  2684.     executing a ShortCut macro are described in the main  BOYAN  manual  on
  2685.     page 13.   To  refresh  your  memory, the following example is included
  2686.     here:
  2687.  
  2688.     ~ATZ{''''\$''''HI, I"'M MIKE
  2689.  
  2690.        The  example  pauses  BOYAN  for  one-half  second,  then sends  ATZ
  2691.     <Return> to the modem.  The  apostrophes  are for spacing and the macro
  2692.     processor ignores them.  The \$  command  causes ShortCut macro # 14 to
  2693.     be processed.  Finally, the phrase  HI, I'M MIKE  is sent to the modem,
  2694.  
  2695.  
  2696.  
  2697.     Section A.3                                                     Page 40
  2698.  
  2699.  
  2700.  
  2701.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 41
  2702.  
  2703.  
  2704.     where the quotation mark says that  the  next character is to be quoted
  2705.     rather than ignored.
  2706.  
  2707.  
  2708.     A.6  Pause Commands
  2709.  
  2710.  
  2711.     \PA[##]                                                         \PA[15]
  2712.     Pause for the specified number of  seconds.   This is an alternative to
  2713.     the  ~  command, which inserts only a single half-second pause.
  2714.  
  2715.     \PU[##:##]                                                   \PU[23:35]
  2716.     Pause Until the specified time.   Use  24-hour  format for the time.  A
  2717.     shortened acceptable form is  simply   \PU[##] , which pauses until the
  2718.     specified hour.  Note that midnight is 0:00.
  2719.  
  2720.     \UNstring[macro]                                    \UN'End of file[^K]
  2721.     UNtil the specified  string  arrives from the modem, repeatedly execute
  2722.     the enclosed macro.    The  above  example sends a continuous stream of
  2723.     control-K characters until BOYAN sees the  End of file  message.
  2724.  
  2725.     \UT##:##[macro]                                           \UT'0:00[\AL]
  2726.     Until the  specified  Time  (24-hour  format),  repeatedly  execute the
  2727.     enclosed  macro.    The  above  example  would  sound the  alarm  until
  2728.     midnight.
  2729.  
  2730.     \WF[]                                                             \WF[]
  2731.     \WF[string]                          \WF[Enter your name:]John Johnson{
  2732.     Wait  For the specified string to arrive from the modem.  If 30 seconds
  2733.     (or whatever value you configure or set with the  \TO  command) elapses
  2734.     before the string appears, the macro times out and will continue to the
  2735.     next command.  The string IS case-sensitive, so  NAME    will not match
  2736.     NaMe .  If the brackets are  empty,  BOYAN  will  simply  wait  for ANY
  2737.     character.    You  can use the  \IW  command to test for the success of
  2738.     the waitfor (page 46).
  2739.  
  2740.     \WL                                                                 \WL
  2741.     Wait for a new Line (carriage return) from the modem.
  2742.  
  2743.     \WP[##]                                                         \WP[2]{
  2744.     This command instructs BOYAN to Wait for the remote system to Pause for
  2745.     ## seconds.  This is very convenient; in  most  cases,  a  command like
  2746.     \WP[2]  means that BOYAN will wait until the next prompt for input!  In
  2747.     other  words, this can often be used in lieu of  \WF  to  automatically
  2748.     wait for the next prompt.
  2749.  
  2750.  
  2751.     A.7  Input/Output Commands
  2752.  
  2753.  
  2754.     \AG+      and   \AG-
  2755.     Turn Ansi Graphics mode on and off, respectively.
  2756.  
  2757.  
  2758.  
  2759.  
  2760.     Section A.6                                                     Page 41
  2761.  
  2762.  
  2763.  
  2764.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 42
  2765.  
  2766.  
  2767.     \AL
  2768.     If beeps & bells are on, sound a 2-second ALarm at the configured sound
  2769.     level (see manual page 10).
  2770.  
  2771.     \AV[##]                                                          \AV[4]
  2772.     Change the alarm volume from 1 to 10, or disable the alarm with 0.
  2773.  
  2774.     \BB+      and   \BB-
  2775.     Turn Beeps & Bells mode on and off, respectively.
  2776.  
  2777.     \CH[##]                                                         \CH[27]
  2778.     Sends  the  CHaracter  having  the  specified ASCII code, as the  above
  2779.     example would send the <Escape> character.
  2780.  
  2781.     \DM[string]                                    \DM[You have connected!]
  2782.     \DM##[string]                             \DM1[File transfer complete.]
  2783.     \DM##,##[string]                              \DM40,10[Menu of Options]
  2784.     The \DM command is used to display a message on the screen.  The status
  2785.     line color  is  always  used.   If printer logging is on, the string is
  2786.     printed as well; likewise, if file  logging  is on, the string is saved
  2787.     in the log.   If BOYAN finds no numbers between the \DM command and the
  2788.     [string], the message will be displayed all the way to the right of the
  2789.     line above the cursor.  If one number in the valid  row  range  1-24 is
  2790.     found  there, the message will be displayed all the way to the right of
  2791.     the  specified line number.  Finally if two  numbers,  separated  by  a
  2792.     comma,  are found which correspond to a legal  column  (1-80)  and  row
  2793.     (1-24) position, the message will be displayed at that location.   This
  2794.     could be used in conjunction with  the  \UI command to make user menus,
  2795.     for example.
  2796.  
  2797.     \EC+      and   \EC-
  2798.     Turn ECho mode on and off, respectively.
  2799.  
  2800.     \GM+      and   \GM-
  2801.     Turn Gossip Mode on and off, respectively.
  2802.  
  2803.     \GX[##]                                                         \GX[40]
  2804.     Go to the specified X position, i.e., move the cursor horizontally to a
  2805.     column from 1 to 80.
  2806.  
  2807.     \GY[##]                                                         \GY[20]
  2808.     Go to the specified Y position,  i.e.,  move the cursor vertically to a
  2809.     row from 1 to 24.
  2810.  
  2811.     \LD+[filename]                         \LD+[c:\modem\text\messages.log]
  2812.     \LD+[]   and   \LD-                                    \LD+[]\WP[2]\LD-
  2813.     The  first  command  begins Logging to the specified Disk file.  If the
  2814.     brackets are empty,  the  default  log  file  will be used.  \LD- turns
  2815.     logging off in either case.
  2816.  
  2817.     \LF+      and   \LF-
  2818.     Turn add Line Feeds mode on and off, respectively.
  2819.  
  2820.  
  2821.  
  2822.  
  2823.     Section A.7                                                     Page 42
  2824.  
  2825.  
  2826.  
  2827.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 43
  2828.  
  2829.  
  2830.     \PI
  2831.     Printer Initialization.  BOYAN sends any initialization string you have
  2832.     configured in Config Area A  to the printer.
  2833.  
  2834.     \PR+      and   \PR-
  2835.     Turn PRinter log mode on and off, respectively.
  2836.  
  2837.     \PS
  2838.     Print Screen.  This is identical to manually keying Shift-PrtSc.
  2839.  
  2840.     \RC
  2841.     Reset the default text Color.
  2842.  
  2843.     \RX[##]                                                        \RX[-10]
  2844.     Move relatively in the  X  direction by the specified number of spaces,
  2845.     i.e., move  the cursor backward (negative numbers) or forward (positive
  2846.     numbers).  The cursor will not go beyond either end of the line.
  2847.  
  2848.     \RY[##]                                                          \RY[5]
  2849.     Move relatively in the Y direction by the specified  number  of  lines,
  2850.     i.e., move the cursor up (negative numbers) or down (positive numbers).
  2851.     The cursor will not go beyond either end of the page.
  2852.  
  2853.     \SA[##]                                                         \SA[50]
  2854.     Set the number of seconds for the alarm which BOYAN sounds after a file
  2855.     transfer (0-255).  The change is not saved to disk.
  2856.  
  2857.     \SS
  2858.     Save the current Screen to the screen dump file.
  2859.  
  2860.     \TT+      and   \TT-
  2861.     Turn the Translate Table on and off, respectively.
  2862.  
  2863.     \XX+      and   \XX-
  2864.     Turn Xon/Xoff pacing mode on and off, respectively.
  2865.  
  2866.     \ZS
  2867.     "Zaps" or clears Screen.
  2868.  
  2869.  
  2870.     A.8  Modem Commands
  2871.  
  2872.  
  2873.     \AD+      and   \AD-
  2874.     Turn the Auto Detect baud rate feature on and off, respectively.
  2875.  
  2876.     \CD[#]                                                           \CD[2]
  2877.     Change the current communications Device to port 1 or 2.
  2878.  
  2879.     \CP[c]                                                           \CP[E]
  2880.     Changes  the  current  modem  Parity  setting  to  None, Even,  or  Odd
  2881.     depending on whether  c  is N, E, or  O.  (You may use the full word if
  2882.     you wish, like  \CP[Even] .)
  2883.  
  2884.  
  2885.  
  2886.     Section A.7                                                     Page 43
  2887.  
  2888.  
  2889.  
  2890.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 44
  2891.  
  2892.  
  2893.     \CS[#]                                                           \CS[2]
  2894.     Changes the current modem Speed setting to 300, 1200,  2400,  4800,  or
  2895.     9600 baud depending on whether  #  is 3, 1, 2,  4,  or 9.  (You may use
  2896.     the full number if you wish, like  \CS[2400] .)
  2897.  
  2898.     \DD+      and   \DD-
  2899.     The first command will cause the Dtr signal to be Dropped  upon exiting
  2900.     BOYAN or changing comm ports.
  2901.  
  2902.     \DI[]
  2903.     \DI[##]                                                         \DI[12]
  2904.     \DI[string]                                               \DI[381-6441]
  2905.     If the brackets are empty, the \DI command enters the dialing directory
  2906.     as if you  had typed <Alt-D>.  If a number from 1-200 is enclosed, this
  2907.     command dials the system with the specified dialing directory code; any
  2908.     automatic  LogOn script will also be run (see  page  50).    Otherwise,
  2909.     BOYAN attempts to manually dial the enclosed string.
  2910.  
  2911.     \DT+      and   \DT-
  2912.     Turn the Data Terminal ready signal on and off, respectively.
  2913.  
  2914.     \HU
  2915.     Hang Up the modem.
  2916.  
  2917.     \PL
  2918.     Purge the data  Line  of  all  incoming  characters;  i.e.,  ignore all
  2919.     incoming characters until the receive buffer is empty.
  2920.  
  2921.     \QA[##]                                                         \QA[12]
  2922.     \QA[string]                                               \QA[381-6441]
  2923.     If a number from 1-200 is  enclosed,  this command Adds the system with
  2924.     the specified dialing directory code  to  the  Queue;  otherwise, BOYAN
  2925.     adds  the enclosed string as a manual entry in the queue.  To add  more
  2926.     than one number to the queue, use multiple  \QA[##]  commands.
  2927.  
  2928.     \QC
  2929.     Clear the Queue of all entries.  You will have to manually verify this,
  2930.     or wait for BOYAN's keyboard timeout period to expire.
  2931.  
  2932.     \QD
  2933.     Repeatedly dial from the Queue until a connection is made.   When BOYAN
  2934.     connects, it loads the script file associated with the connected system
  2935.     (specified in the Dialing  Directory).   Then, if BOYAN is attended, it
  2936.     runs the block labelled "LOGON"; if BOYAN is unattended,  it  runs  the
  2937.     block labelled "AUTO".  See page 50 for details.  The system is removed
  2938.     from the queue, but the others remain until the next  \QD  command.
  2939.  
  2940.     \QU[]                                                             \QU[]
  2941.     \QU[##:##]                                                    \QU[7:30]
  2942.     This Queue-redials as the  \QD  command  does,  except  that  after the
  2943.     LOGON    or    AUTO    block  has finished, redialing resumes with  the
  2944.     remaining systems in the queue.  This repeats until the specified time,
  2945.     in  24-hour  notation.    When  that  time  is reached (7:30 am in  the
  2946.     example), the current call will come to completion, but no more dialing
  2947.  
  2948.  
  2949.     Section A.8                                                     Page 44
  2950.  
  2951.  
  2952.  
  2953.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 45
  2954.  
  2955.  
  2956.     will occur.  If  the  brackets  are  empty, queue-redialing will simply
  2957.     repeat until the queue is empty.
  2958.  
  2959.     \SB
  2960.     Send modem Break signal.
  2961.  
  2962.  
  2963.     A.9  Conditional Commands
  2964.  
  2965.  
  2966.     \AT+[macro]                                                   \AT+[\MM]
  2967.     \AT-[macro]                                             \AT-[\bl[AUTO]]
  2968.     The  first  command  processes the enclosed  macro  only  if  BOYAN  is
  2969.     ATtended, that is,  if  you  are  at  the keyboard.  The second command
  2970.     processes the enclosed macro only if BOYAN is not attended,  when BOYAN
  2971.     is under script  control.  If the middle of the Status Line says  BOYAN
  2972.     v.D3 , then  BOYAN  is  attended;  when  the  name  of a script file is
  2973.     flashing there, BOYAN is unattended.
  2974.  
  2975.     \CA+[macro]                              \CA+[\DM[You have connected!]]
  2976.     \CA-[macro]                                               \CA-[ATS0=0{]
  2977.     The  first  command  processes the enclosed macro only if BOYAN detects
  2978.     carrier,  that is, if the modem is currently  connected.    The  second
  2979.     processes its macro only if BOYAN does not detect carrier.
  2980.  
  2981.     \FE+filename[macro]          \FE+c:\files\twiddle.arc[\UL[twiddle.arc]]
  2982.     \FE-filename[macro]                 \FE-boyan.arc[\DC[arc a boyan *.*]]
  2983.     With the first  command,  the  enclosed  macro is processed only if the
  2984.     specified file exists on  your  disk.  The second command processes the
  2985.     enclosed macro only if the specified file does not already exist.
  2986.  
  2987.     \IF+string[macro]                      \IF+End of messages[\GB[LogOff]]
  2988.     \IF-string[macro]                 \IF-File not found[\DLk[twiddle.arc]]
  2989.     The first command processes  the  enclosed macro only IF the string you
  2990.     specify is currently on the same screen line as the cursor.  The second
  2991.     command  processes  its  macro only if the string is not on the current
  2992.     line.
  2993.  
  2994.     \IP+C[macro]                                  \IP+K[\DLk[CVTFON14.ARC]]
  2995.     \IP-C[macro]                          \IP-Z[\DM[Zmodem not installed.]]
  2996.     The  \IP+ command processes the enclosed macro  only  If  the  Protocol
  2997.     specified by the  character  C  is  available.  The first example above
  2998.     performs  a  "K"  (Kermit) download only  if  the  Kermit  protocol  is
  2999.     available.  The \IP-  command  processes the enclosed macro only if the
  3000.     specified  protocol  is  not  available.    Both  BOYAN's built-in  and
  3001.     external protocols can be tested with this command.
  3002.  
  3003.     \IS+##,##,##[macro]                       \IS+1,6,114,0,3,30[password1]
  3004.     \IS-##,##,##[macro]                                    \IS-0[password2]
  3005.     The  first  command  processes the enclosed macro only If the directory
  3006.     code of the System you  last  dialed  is  on  the list of numbers.  The
  3007.     second command processes the enclosed macro when the last-dialed system
  3008.     is  not  on  the code list.  The  codes  run  from  1-200  for  dialing
  3009.     directory  entries,  and  0  for  manual  dialing.    This  command  is
  3010.  
  3011.  
  3012.     Section A.8                                                     Page 45
  3013.  
  3014.  
  3015.  
  3016.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 46
  3017.  
  3018.  
  3019.     convenient when, for example, you use different passwords on otherwise-
  3020.     identical systems, and need to select a password based on  which system
  3021.     you connected to.
  3022.  
  3023.     \IT+[macro]                \DLy[]\IT+[\DM[Ymodem download successful.]]
  3024.     \IT-[macro]             \ULk[boyan-D3.arc]\IT-[\DM[Kermit upload bad.]]
  3025.     The first command processes the enclosed macro only If the  most recent
  3026.     Transfer completed successfully.    The  second  command  processes its
  3027.     macro only if the last transfer was unsuccessful.  This test applies to
  3028.     both transfers started manually (e.g., with the <PgUp>  or  <PgDn> key)
  3029.     and transfers started within a macro or script  (with  the  \DL  or \UL
  3030.     command).
  3031.  
  3032.     \IV+string[macro]                    \IV+IBMPC[\dm[Password is IBMPC.]]
  3033.     \IV-string[macro]                   \IV-IBMPC[\dm[Incorrect password!]]
  3034.     This command is described on page 52.
  3035.  
  3036.     \IW+[macro]                               \IW+[\DM[Log-on successful!]]
  3037.     \IW-[macro]                     \IW-[\DM[Log-on interrupted.]\GB[quit]]
  3038.     The first command processes the enclosed macro only If the last Waitfor
  3039.     or  until command was successful.  The  second  command  processes  the
  3040.     enclosed macro only if the last waitfor or until command timed out.
  3041.  
  3042.     \UIc[macro]                                  \DM[Hang up now?]\UIY[\HU]
  3043.     The User Inputs one character from the keyboard.  If this  character is
  3044.     the  same  as c, then the enclosed macro is processed.   In  the  above
  3045.     example, responding  Y  or  y  to the question will turn control to the
  3046.     block labelled LogOff.
  3047.  
  3048.  
  3049.     A.10  DOS/File Commands
  3050.  
  3051.  
  3052.     \CF+      and   \CF-
  3053.     The  first  command  tells BOYAN to automatically Check Free disk space
  3054.     before each download  and  within  the  directory file manager.  If the
  3055.     second command is  in  effect,  you  must manually press <Alt-F> in the
  3056.     download menu or <F> in the dir manager to see remaining disk space.
  3057.  
  3058.     \DC[string]                                              \DC[dir >prn:]
  3059.     Attempts to shell the enclosed Dos Command.
  3060.  
  3061.     \DL[]
  3062.     \DLc[]                                                           \DLX[]
  3063.     \DL[filename]                           \DL[c:\modem\files\twiddle.arc]
  3064.     \DLc[filename]                                        \DLY[twiddle.arc]
  3065.     When DownLoading a file you may specify 1) both the protocol to use and
  3066.     the  filename,  2)  just  one  of  those,  or 3) neither.  Specify  the
  3067.     protocol using the letter  from  the  protocol menu (X,C,Y,G,A,Z,K); if
  3068.     you do not specify the protocol, BOYAN will use  the  default  protocol
  3069.     you  have  configured.   If you do not specify the filename, BOYAN will
  3070.     use  its  automatic  filename-find  feature  to  determine   the  name.
  3071.     Warning: if you do not specify a filename and  BOYAN  cannot  determine
  3072.     the name from the screen, OR if you specify a file that already exists,
  3073.  
  3074.  
  3075.     Section A.9                                                     Page 46
  3076.  
  3077.  
  3078.  
  3079.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 47
  3080.  
  3081.  
  3082.     BOYAN will create a file called FILE####.BDL, where ####  is  the  time
  3083.     when the download started.  If  BOYAN  is  attended you will be able to
  3084.     confirm  the  path and filename.  You may use the \IT  command  to  act
  3085.     based on the success of the transfer.
  3086.  
  3087.     \FE+filename[macro]               \FE+twiddle.arc[\DC[del twiddle.arc]]
  3088.     \FE-filename[macro]                 \FE-boyandoc.arc[\DLk[twiddle.arc]]
  3089.     This command is described on page 45.
  3090.  
  3091.     \JD                                                           \AT+[\JD]
  3092.     Jump  to  DOS.  You must type  EXIT <Return>  to return to  BOYAN  from
  3093.     DOS, so be sure this command is not processed when BOYAN is unattended.
  3094.  
  3095.     \ND[string]                                            \ND[b:\download]
  3096.     Select a New default Directory.
  3097.  
  3098.     \UF+      and   \UF-
  3099.     Turn the BOYAN.USE Usage File on  and  off, respectively.  By placing a
  3100.     \UF  command  in  an  auto-logon  macro, for example, you could  choose
  3101.     whether or not BOYAN logged calls to that number.
  3102.  
  3103.     \UL[]
  3104.     \ULc[]                                                           \ULX[]
  3105.     \UL[filename]                           \UL[c:\modem\files\twiddle.arc]
  3106.     \ULc[filename]                                        \ULY[twiddle.arc]
  3107.     The use of this command, UpLoad  file,  is  analogous to the use of the
  3108.     \DL    command.   If the file is not found on disk, the upload will not
  3109.     occur.  You may use  the \IT command to act based on the success of the
  3110.     transfer.
  3111.  
  3112.     \UM[string]                                  \UM[Script file activated]
  3113.     This  "Usage  Message" command lets you manually  add  a  line  to  the
  3114.     BOYAN.USE usage file.  The date and time are automatically added to the
  3115.     file  as well.  This command only takes effect if the Usage File is  on
  3116.     (see page 31 and the \UF macro command).
  3117.  
  3118.     \WW+      and   \WW-
  3119.     Respectively, enable  and  disable  the  automatic  Word  Wrap handling
  3120.     feature of message uploads.
  3121.  
  3122.  
  3123.     A.11  Miscellaneous Commands
  3124.  
  3125.  
  3126.     \DP[c]                                                           \DP[K]
  3127.     Set  the  default  protocol.    Use  the  first  letter of the protocol
  3128.     (X,C,Y,G,A,Z,or K).  The old default protocol will be restored the next
  3129.     time you start BOYAN.
  3130.  
  3131.     \EX                                                             \DD-\EX
  3132.     EXIT  from BOYAN.  When this command is processed, you will be asked to
  3133.     verify the exit;  if  BOYAN  is  unattended you have until the keyboard
  3134.     times out to  press <N>.  After timing out, BOYAN exits, and if you ran
  3135.     BOYAN from a batch file, the batch file picks up where it left off.
  3136.  
  3137.  
  3138.     Section A.10                                                    Page 47
  3139.  
  3140.  
  3141.  
  3142.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 48
  3143.  
  3144.  
  3145.     \KO[##]                                                          \KO[5]
  3146.     Set the unattended Keyboard timeOut value  to  ## seconds.  This is the
  3147.     amount of time BOYAN will wait for keyboard input when it is unattended
  3148.     before accepting the default response.
  3149.  
  3150.     \KM[##]                                                          \KM[8]
  3151.     Accept a string from the keyboard, and assign it to the  numbered BOYAN
  3152.     macro (1-70).  The change is saved to disk.
  3153.  
  3154.     \SM##[string]                                           \SM69[password]
  3155.     Set  the numbered macro to the enclosed string.  The change is saved to
  3156.     disk.
  3157.  
  3158.     \TO[##]                                                         \TO[45]
  3159.     Set the handshake TimeOut value to ## seconds.  This  is  the amount of
  3160.     time BOYAN will wait for  a handshake with the  \WF  command.  NOTE: if
  3161.     you  set  this  value to its maximum, 255 seconds, then BOYAN will wait
  3162.     indefinitely for the handshake.
  3163.  
  3164.     \TR+      and   \TR-
  3165.     BOYAN's  macro  language  has a TRace feature that may be turned on and
  3166.     off,  respectively, with these two commands.  When  trace  is  on,  the
  3167.     middle of the Status Line displays the two letters of the current macro
  3168.     command  being processed.  If you have a problem with a script file you
  3169.     are designing, this may help you pinpoint the error.
  3170.  
  3171.  
  3172.     A.12  Macro String Replacements
  3173.  
  3174.  
  3175.        The following commands, wherever they  are found within a macro, are
  3176.     replaced by a number or string  as  described below before the macro is
  3177.     run.  They can all also be used in printer strings and messages.
  3178.  
  3179.     \HN
  3180.     Wherever the  \HN  command  is  found in a macro, it is replaced by the
  3181.     number corresponding to the Hour Now.
  3182.  
  3183.     \MN
  3184.     The \MN command is replaced by the Minute Now.
  3185.  
  3186.     \SN                                       \DM[The time is \HN:\MN:\SN.]
  3187.     The \SN command is replaced by the Second Now.
  3188.  
  3189.     \P:                                 \DM[The help file is \P:BOYAN.HLP.]
  3190.     The \P: command is replaced by the full drive and Path specification of
  3191.     the BOYAN disk directory.    This is useful in external protocol macros
  3192.     (see page 18).
  3193.  
  3194.     \MD                                                            \CD[\MD]
  3195.     The \MD command is  replaced  by the number of the currently-open Modem
  3196.     Device (1 or 2).  The example macro above causes BOYAN to change device
  3197.     to the currently-open device; in  other  words,  it  re-initializes the
  3198.     modem device.  \MD is also useful in external protocol macros.
  3199.  
  3200.  
  3201.     Section A.11                                                    Page 48
  3202.  
  3203.  
  3204.  
  3205.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 49
  3206.  
  3207.  
  3208.     \MP
  3209.     The \MP command is replaced by the letter corresponding to  the current
  3210.     Modem Parity: N for None, E for Even, O for Odd.
  3211.  
  3212.     \MS
  3213.     The  \MS command is replaced by the current  Modem  Speed:  300,  1200,
  3214.     2400, 4800, or 9600.
  3215.  
  3216.     \XP
  3217.     The \XP command is replaced by the current X position (1-80).
  3218.  
  3219.     \YP                                    \DM[Cursor position is \XP,\YP.]
  3220.     The \YP command is replaced by the current Y position (1-24).
  3221.  
  3222.  
  3223.     A.13  Macro Flow Commands
  3224.  
  3225.  
  3226.     \\string                           \DL[]\\that command downloads a file
  3227.     BOYAN ignores all characters in a macro after the \\ command.  Use this
  3228.     to insert comments or remarks in a macro.
  3229.  
  3230.     \MA[##]                                                          \MA[9]
  3231.     Nest the BOYAN macro with the specified number (1-70).
  3232.  
  3233.     \MM                                     \DM[Enter manual macro now:]\MM
  3234.     Accept input from the keyboard, and process the input as a macro.  This
  3235.     is an easy way to handle a macro which needs  to  change slightly every
  3236.     time, as long as BOYAN is attended.
  3237.  
  3238.     \RE##[macro]                                                \RE5[\WF[]]
  3239.     REpeat  the  enclosed  macro ## times, where ## is an integer between 1
  3240.     and 32767.  The above example would wait for five characters  to arrive
  3241.     from the modem.
  3242.  
  3243.  
  3244.     A.14  BOYAN Script Files
  3245.  
  3246.  
  3247.        BOYAN script files can have any name and can be  placed  in any disk
  3248.     directory; however, it is easiest to give them all a suffix of .BSC and
  3249.     place them in the same directory as BOYAN itself.    Auto-logon  script
  3250.     files MUST have a suffix of .BSC.  If you wish,  you  may  separate the
  3251.     parts of a single script file into blocks.    A  block  is defined by a
  3252.     line  of text which starts with the vertical bar  |  symbol (at  bottom
  3253.     left of keyboard) plus a block label.   Labels  can  be  as long as you
  3254.     wish,  but  only  the  first  five  characters  are significant,  e.g.,
  3255.     MessageWrite  and  MessageRead   are  equivalent labels.  Since case is
  3256.     insignificant,  LOGON  and LogOn also refer to the  same  block.  Blank
  3257.     lines  in  a script file are ignored.    Several  example  scripts  are
  3258.     included in the BOYAN-D3.ARC archive.
  3259.  
  3260.  
  3261.  
  3262.  
  3263.  
  3264.     Section A.12                                                    Page 49
  3265.  
  3266.  
  3267.  
  3268.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 50
  3269.  
  3270.  
  3271.     A.15  Logon Scripts
  3272.  
  3273.  
  3274.        The most common  use  of  script  files  is  probably  for automatic
  3275.     logging-on  to  a  system.  Rather than mechanically entering your name
  3276.     and password each time you connect,  it  makes sense that a script file
  3277.     should be able to do this  for  you.   BOYAN allows a completely hands-
  3278.     free  logon  through  its  dialing  directory Script field.  Using  the
  3279.     <E>dit command in the dialing directory, you can assign  each  entry  a
  3280.     1-8 character script name, like  RBBS  or  MCIMAIL .  The next time you
  3281.     connect to the system using the <Alt-D> Dial or  <Alt-Q>  Queue  Redial
  3282.     commands, BOYAN loads the  specified  script  file  (the .BSC suffix is
  3283.     automatically added).  It then searches  for  a block labelled  LOGON ;
  3284.     if this block is found, it is executed; otherwise, the entire script is
  3285.     processed.
  3286.  
  3287.  
  3288.     A.16  Automatic Unattended Session Scripts
  3289.  
  3290.  
  3291.        The most powerful type of script, the type described in the appendix
  3292.     introduction,  is  the  type  which  carries  out  one or  more  entire
  3293.     communication sessions from logon to logoff without  operator presence.
  3294.     As described above, BOYAN runs the  LOGON  block of a directory entry's
  3295.     script when you dial with <Alt-D> or <Alt-Q>.    However,  if  a script
  3296.     file is actually doing the dialing, BOYAN is said  to  be  "unattended"
  3297.     and a different block (from the same script file) is run:    the   AUTO
  3298.     block.    Usually, the first command in an  AUTO  block is to  run  the
  3299.     LOGON    block;  after that, further commands can be given to print all
  3300.     new  messages,  transfer  files,  and  log  off.    Again, refer to the
  3301.     included .BSC scripts for examples.
  3302.  
  3303.  
  3304.     A.17  Running Script Files
  3305.  
  3306.  
  3307.        BOYAN can automatically process  a  script  file  after successfully
  3308.     dialing.  However, you may often need to run a file at some other time.
  3309.     BOYAN provides a number of convenient methods for  executing  either an
  3310.     entire script file or just a single block from a script file.
  3311.  
  3312.        When  specifying  a  script  file,  you  may  include  the  script's
  3313.     directory, its name  (.BSC  suffix assumed), and optionally a semicolon
  3314.     and a block label.  For example, the  following  are  all  valid script
  3315.     specifiers:
  3316.      - a:INIT
  3317.  
  3318.      - RBBS.BSC;LogOn
  3319.  
  3320.      - c:\modem\text\tcomm;DownLoad
  3321.     If you  do  not  include  a block label, as in the first example above,
  3322.     BOYAN will run the entire script from start to finish.  IMPORTANT NOTE:
  3323.     Once a script file takes control, the    BOYAN  v.D3    message  in the
  3324.     middle of the status line disappears, and the script file  name flashes
  3325.  
  3326.  
  3327.     Section A.15                                                    Page 50
  3328.  
  3329.  
  3330.  
  3331.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 51
  3332.  
  3333.  
  3334.     in its place.  When this happens, BOYAN is "unattended" and  its normal
  3335.     terminal  mode commands are disabled.  To  regain  control  before  the
  3336.     script file finishes, you must press the <Esc> key.
  3337.  
  3338.        The  first  way  to run a script is with the  <Alt-R>  command  from
  3339.     terminal mode.  You will be asked to specify a script  file  name.   If
  3340.     you do not include  a  block label, BOYAN will double-check your choice
  3341.     by asking you specifically what block to run.  At  the  BLOCK:  prompt,
  3342.     you may either enter a label or simply press <Return> to run the entire
  3343.     script.
  3344.  
  3345.        The  second  way  to select a script file is directly from the <Del>
  3346.     Disk Directory (page 32).  If the file  cursor  is  over  a file with a
  3347.     .BSC  suffix,  pressing  <E> will execute the script.  You will be then
  3348.     asked to enter a block label as described above.
  3349.  
  3350.        Another way to run a script file is directly from the  BOYAN command
  3351.     line.  Instead  of typing only  BOYAN <Return>  at the DOS prompt, type
  3352.     BOYAN  plus the script specifier, like
  3353.  
  3354.          BOYAN RBBS;Auto
  3355.  
  3356.     If you plan  carefully,  you can set up BOYAN to run in the middle of a
  3357.     batch file as described in the introduction!
  3358.  
  3359.        Running  a  script  file, like most  other  BOYAN  actions,  can  be
  3360.     programmed  into  the  70 user-definable BOYAN macros.  If you commonly
  3361.     need the LogOff block of the  TCOMM.BSC  file, you can set any function
  3362.     key to run that block for you.  Another use might be to set  macro  # 9
  3363.     (Start-Up  macro)  or  macro  #  10  (Conclude  macro)  to  have  BOYAN
  3364.     automatically run a STARTUP.BSC or  CONCLUDE.BSC  script  each  time it
  3365.     started or concluded.  Thus there are four different ways to start up a
  3366.     BOYAN script file.
  3367.  
  3368.  
  3369.     A.18  Script Flow Commands
  3370.  
  3371.  
  3372.     \AB
  3373.     ABORTS ALL CURRENTS SCRIPT FILES; return to terminal mode.
  3374.  
  3375.     \BL[label]                                                   \BL[LogOn]
  3376.     Nests  the  BLock  with the specified  label.    When  that  block  has
  3377.     completed, control is returned to the calling macro.
  3378.  
  3379.     \EB                                            \IF+end of messages[\EB]
  3380.     End the current Block.    This can occur within a conditional statement
  3381.     to end the block prematurely.
  3382.  
  3383.     \GB[label]                                                   \GB[LogOn]
  3384.     Go directly to  the  Block  with  the  specified label.  Control is not
  3385.     returned to the calling macro.
  3386.  
  3387.     \GS[filename]                                                 \GS[rbbs]
  3388.  
  3389.  
  3390.     Section A.17                                                    Page 51
  3391.  
  3392.  
  3393.  
  3394.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 52
  3395.  
  3396.  
  3397.     \GS[filename;label]                                  \GS[rbbs;messages]
  3398.     Go  directly to the Script with the  specified  filename  (.BSC  suffix
  3399.     assumed).  If a semicolon and  label  are given, the specified block is
  3400.     executed; otherwise, the entire script runs from start to finish.
  3401.  
  3402.     \SC[filename]                                                 \SC[rbbs]
  3403.     \SC[filename;label]                                     \SC[rbbs;LogOn]
  3404.     Nest the script with the specified filename (.BSC suffix assumed).   If
  3405.     a  semicolon  and  label  are  given, the specified block is  executed;
  3406.     otherwise,  the entire script runs from start to  finish.    When  that
  3407.     script has completed, control is returned to the calling macro.
  3408.  
  3409.  
  3410.     A.19  Script Variable Commands
  3411.  
  3412.  
  3413.     \VV
  3414.     BOYAN's script language offers a variable, \VV, which  can  be inserted
  3415.     in any macro at any place.  It can hold a filename, a number, a string,
  3416.     or  even a macro command.  Any  \VV  symbols within  a  macro  will  be
  3417.     replaced by the variable  before  the macro is processed.  For examples
  3418.     of the variable's use, see page 55.
  3419.  
  3420.     \IV+string[macro]                             \IV+G[\dm[Variable = G.]]
  3421.     \IV-string[macro]                        \IV-Justin Boyan[\dm[Bye.]\hu]
  3422.     The first command processes the enclosed macro only if BOYAN's variable
  3423.     equals  the string given.  The second  command  executes  the  enclosed
  3424.     macro  when  the  variable is different  from  the  string.    Case  is
  3425.     insignificant, so BoYaN matches bOyAn.
  3426.  
  3427.     \KV
  3428.     This  macro  command  reads  the  macro  variable  from  the  keyboard.
  3429.     Whatever you type will replace the  \VV  symbols  starting  in the next
  3430.     macro.
  3431.  
  3432.     \RV[##]
  3433.     Read  up to ## characters from the modem,  stopping  when  <Return>  is
  3434.     pressed.  Simple  editing  with  the  backspace key is permitted.  This
  3435.     command is used  heavily  in  BOYAN's  Host  Mode.  The success of this
  3436.     variable read can be tested with the  \IW  command described above.
  3437.  
  3438.     \SV[string]
  3439.     Set the variable to the enclosed string.
  3440.  
  3441.  
  3442.     A.20  Macro Command Summary
  3443.  
  3444.  
  3445.     '                       \!                      \&
  3446.     "c                      \@                      \*
  3447.     ^c                      \#                      \(
  3448.     {                       \$                      \)
  3449.     ~                       \%                      |label
  3450.     \\                      \^                      \AB
  3451.  
  3452.  
  3453.     Section A.18                                                    Page 52
  3454.  
  3455.  
  3456.  
  3457.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 53
  3458.  
  3459.  
  3460.     \AD+                    \GB[label]              \PS
  3461.     \AD-                    \GM+                    \PU[##:##]
  3462.     \AG+                    \GM-                    \QA[##]
  3463.     \AG-                    \GS[filename]           \QA[string]
  3464.     \AL                     \GS[filename;label]     \QC
  3465.     \AT+[macro]             \GX[##]                 \QD
  3466.     \AT-[macro]             \GY[##]                 \QU[##:##]
  3467.     \AV[##]                 \HN                     \RC
  3468.     \BB+                    \HU                     \RE##[macro]
  3469.     \BB-                    \IF+string[macro]       \RX[##]
  3470.     \BL[label]              \IF-string[macro]       \RY[##]
  3471.     \CA+[macro]             \IS+##,##,##[macro]     \SA[##]
  3472.     \CA-[macro]             \IS-##,##,##[macro]     \SB
  3473.     \CD[#]                  \IT+[macro]             \SC[filename;label]
  3474.     \CF+                    \IT-[macro]             \SM##[string]
  3475.     \CF-                    \IV+string[macro]       \SN
  3476.     \CH[##]                 \IV-string[macro]       \SS
  3477.     \CP[c]                  \IW+[macro]             \TO[##]
  3478.     \CS[#]                  \IW-[macro]             \TR+
  3479.     \DC[string]             \JD                     \TR-
  3480.     \DD+                    \KM[##]                 \TT+
  3481.     \DD-                    \KO[##]                 \TT-
  3482.     \DI[]                   \KV                     \UF+
  3483.     \DI[##]                 \LD+                    \UF-
  3484.     \DI[string]             \LD+[filename]          \UIc[macro]
  3485.     \DL[]                   \LD-                    \UL[]
  3486.     \DLc[]                  \LF+                    \ULc[]
  3487.     \DL[filename]           \LF-                    \UL[filename]
  3488.     \DLc[filename]          \MA[##]                 \ULc[filename]
  3489.     \DM[string]             \MD                     \UM[string]
  3490.     \DM##[string]           \MM                     \UNstring[macro]
  3491.     \DM##,##[string]        \MN                     \UT##:##[macro]
  3492.     \DP[c]                  \MP                     \XP
  3493.     \DT+                    \MS                     \XX+
  3494.     \DT-                    \ND[string]             \XX-
  3495.     \EB                     \P:                     \WF[]
  3496.     \EC+                    \PA[##]                 \WF[string]
  3497.     \EC-                    \PI                     \WL
  3498.     \EX                     \PL                     \WP[##]
  3499.     \FE+filename[macro]     \PR+                    \YP
  3500.     \FE-filename[macro]     \PR-                    \ZS
  3501.  
  3502.  
  3503.     A.21  Macro Examples
  3504.  
  3505.  
  3506.        The following example macros brush the surface of the flexibility of
  3507.     BOYAN's  function key commands.  The first one  provides  a  method  of
  3508.     exiting  BOYAN  without  dropping the DTR  signal,  even  if  BOYAN  is
  3509.     configured to drop DTR:
  3510.  
  3511.  
  3512.  
  3513.  
  3514.  
  3515.  
  3516.     Section A.20                                                    Page 53
  3517.  
  3518.  
  3519.  
  3520.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 54
  3521.  
  3522.  
  3523.     \DD-\EX
  3524.  
  3525.        If  you entered this line as macro # 31, the <F1> key, then pressing
  3526.     <F1> will hold the DTR signal  and  exit  BOYAN.  The next sample shows
  3527.     you can set up macro # 40 (the  <F10>  key)  to  reset the default text
  3528.     color, zap (clear) the screen, and print a disk directory:
  3529.  
  3530.     \RC\ZS\DC[dir >prn:]
  3531.  
  3532.        The following sample could be used as macro # 9,  the Initialization
  3533.     macro which runs automatically each time BOYAN is called up.   It sends
  3534.     the Hayes modem reset string, ATZ <Return>, to the modem only  if there
  3535.     is no carrier detected.  It  displays  a welcome message on the screen.
  3536.     Then it automatically fills  up  the redialing queue with entries 1, 2,
  3537.     and 21, and will dial repeatedly until it has connected with any of the
  3538.     three:
  3539.  
  3540.     \ca-[ATZ{]\dm[Welcome to BOYAN!]\qa[1]\qa[2]\qa[21]\qd
  3541.  
  3542.        The next macro sets up a function key to automatically issue a Hayes
  3543.     modem  command while on-line.  First, BOYAN checks to see if there is a
  3544.     carrier signal, and if  so  it repeatedly sends the +++ modem attention
  3545.     code until the OK message is returned.  It then accepts a macro entered
  3546.     manually from the keyboard, in this case probably a modem  command like
  3547.     ATS0=0  ,  and sends it to the  modem  with  an  accompanying  <Return>
  3548.     character.  Finally, if there is still a carrier  signal,  BOYAN  sends
  3549.     the ATO command to return online.
  3550.  
  3551.     \ca+[\un'OK[~~~+++~~~~]]\MM{\ca+[ATO{]
  3552.  
  3553.  
  3554.     A.22  Script Examples
  3555.  
  3556.  
  3557.        Four  automatic-logon  script  files   are   included   with  BOYAN:
  3558.     TCOMM.BSC, RBBS.BSC, PCBOARD.BSC,  and  FIDO.BSC.    These  scripts are
  3559.     commented, and you can learn a lot about writing your own  scripts from
  3560.     studying these.
  3561.  
  3562.        To use these scripts,  you  must  set  the following ShortCut macros
  3563.     using BOYAN's built-in <Alt-C> configuration:
  3564.  
  3565.     \! ShortCut 11   Set this to your first name.
  3566.  
  3567.     \@ ShortCut 12   Set this to your last name.
  3568.  
  3569.     \# ShortCut 13   Set this to the password you usually use.
  3570.     If you follow these standards, you will only have  to  reconfigure  the
  3571.     ShortCut  macros  when  you  change  your password--you won't  have  to
  3572.     rewrite  all  your  scripts.    NOTE:    You may  have  to  make  minor
  3573.     modifications to the included script files using a text editor in order
  3574.     to make them  work  with  different  TComm,  RBBS,  PC-Board,  and Fido
  3575.     implementations.  If two different systems you call have close  but not
  3576.  
  3577.  
  3578.  
  3579.     Section A.21                                                    Page 54
  3580.  
  3581.  
  3582.  
  3583.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 55
  3584.  
  3585.  
  3586.     identical logon procedures, you may use the \IS command  to  have  your
  3587.     script handle these differences.
  3588.  
  3589.        A   few   other   short  sample  scripts  are  listed  here  in  the
  3590.     documentation to illustrate some basic BOYAN script principles:
  3591.  
  3592.     ======================  Sample Script:  FUN.BSC  ======================
  3593.  
  3594.     \\ This script makes a little twirl on the screen until the
  3595.     \\ string "RING" is found.  The \re30[] command literally means
  3596.     \\ to do nothing 30 times; in reality, it is responsible for a
  3597.     \\ short pause, even shorter than the half-second pause of the  ~
  3598.     \\ command.  If the RING message is found, then the \EB command
  3599.     \\ ends the block; otherwise, the \GB[TWIRL] restarts the block.
  3600.  
  3601.     |TWIRL
  3602.     \dm[|]\re30[]
  3603.     \dm[/]\re30[]
  3604.     \dm[-]\re30[]
  3605.     \dm[\]
  3606.     \if+RING[\EB]
  3607.     \GB[TWIRL]
  3608.  
  3609.     ====================  Sample Script:  VARIABLE.BSC  ===================
  3610.  
  3611.     \\ This script demonstrates the use of the BOYAN \VV variable
  3612.     \\ in automating the download of files packed in ARChives.
  3613.     \\ It could be run immediately after setting up the download
  3614.     \\ from the remote system.
  3615.  
  3616.     |ARCDOWNLOAD
  3617.  
  3618.     \\ The first command line prompts for the filename and reads
  3619.     \\ it into the BOYAN variable from the keyboard.
  3620.  
  3621.     \dm[Enter filename, without .ARC suffix.]\kv
  3622.  
  3623.     \\ The following line checks to see if the specified .ARC
  3624.     \\ file exists, and if so prompts you to confirm its deletion.
  3625.     \\ If you respond No, then the script is aborted.
  3626.  
  3627.     \fe+\VV.ARC[\dm[Delete \VV.ARC?]\ui'N[\ab]]
  3628.  
  3629.     \\ Download the file using the default protocol.
  3630.  
  3631.     \dl[\VV.ARC]
  3632.  
  3633.     \\ If the transfer is not okay, abort the script!
  3634.  
  3635.     \it-[\ab]
  3636.  
  3637.     \\ Send DOS commands to use the ARC program (written by System
  3638.     \\ Enhancement Associates) to extract all files from the ARChive,
  3639.     \\ then delete the archive file itself.
  3640.  
  3641.  
  3642.     Section A.22                                                    Page 55
  3643.  
  3644.  
  3645.  
  3646.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 56
  3647.  
  3648.  
  3649.     \dc[ARC X \VV]
  3650.     \dc[DEL \VV.ARC]
  3651.  
  3652.     \\ Note in the BOYAN.USE usage log that the ARChive is unpacked.
  3653.     \um[Archive contents extracted from \VV.ARC]
  3654.  
  3655.     \\ End of block and script!
  3656.     \dm[\VV files un-archived.]
  3657.     |
  3658.  
  3659.     ====================  Sample Script:  NITETIME.BSC  ===================
  3660.  
  3661.     \\ This script uses the queue dialing commands.  When a system
  3662.     \\ connects, the  AUTO  block of its auto-logon script is run.
  3663.     \\ This script is suitable for running from DOS, i.e.
  3664.     \\ BOYAN NITETIME .  The five systems are repeatedly dialed
  3665.     \\ until all five have been connected OR until 7:00 a.m.,
  3666.     \\ whichever comes first.
  3667.  
  3668.     \QC
  3669.     \QA[1]\QA[2]\QA[5]\QA[7]\QA[24]
  3670.     \QU[7]
  3671.  
  3672.     =======================================================================
  3673.  
  3674.        If you have questions concerning specific things you  want  BOYAN to
  3675.     do, don't hesitate to contact me and ask for help.    Please respect my
  3676.     programming effort by registering!
  3677.  
  3678.                                               - Justin Boyan, July 26, 1987
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.  
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.  
  3704.  
  3705.     Section A.22                                                    Page 56
  3706.  
  3707.  
  3708.  
  3709.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 57
  3710.  
  3711.  
  3712.  
  3713.  
  3714.  
  3715.  
  3716.  
  3717.  
  3718.                                        Index
  3719.  
  3720.  
  3721.                                            break signal 28, 45
  3722.             A
  3723.             AB script command 51           C
  3724.             add linefeeds 21               CA macro command 45
  3725.             address 3                      carrier signal 6, 15,
  3726.             AD macro command 43                 17
  3727.             AG macro command 41            CD macro command 43
  3728.             alarm 10, 28                   CF macro command 46
  3729.             AL macro command 41            change parameters 23
  3730.             Alt-A 21                       chat mode 21
  3731.             Alt-B 21                       CH macro command 42
  3732.             Alt-C 9                        clear screen 20
  3733.             Alt-D 23                       CLINK.EXE 31
  3734.             Alt-E 21                       colors 9, 22
  3735.             Alt-F 33                       command list 8, 20
  3736.             Alt-G 21                       conclude macro 15
  3737.             Alt-H 28                       configuration 9
  3738.             Alt-I 33                          computer 9
  3739.             Alt-J 34                          dialing 14, 38
  3740.             Alt-L 22                          disk 10
  3741.             Alt-M 35                          file transfers 10
  3742.             Alt-N 33                          Hayes modem 15
  3743.             Alt-P 23                          memory 38
  3744.             Alt-Q 27                          modem 12, 13
  3745.             Alt-R 35                          timers 16
  3746.             Alt-S 22                       copying files 33
  3747.             Alt-T 22                       corporations 3
  3748.             Alt-U 22                       CP macro command 43
  3749.             Alt-V 34                       CS macro command 44
  3750.             Alt-X 20                       Ctrl-Backspace 36
  3751.             Alt-Z 20                       Ctrl-End 28
  3752.             ANSI graphics 21               Ctrl-Home 20
  3753.             appendix 14, 39                Ctrl-LeftArrow 36
  3754.             AT macro command 45            Ctrl-PrtSc 22
  3755.             AV macro command 42            Ctrl-RightArrow 37
  3756.                                            customizing BOYAN 38
  3757.             B
  3758.             backspace buffer 36            D
  3759.             BB macro command 42            data bits 38
  3760.             BBS Support 3                  DC macro command 46
  3761.             beeps and bells 9, 21          DD macro command 44
  3762.             BL script command 51           Del 32
  3763.             BOYAN.USE 11, 31               deleting files 33
  3764.             BOYAN Commands 20              dialing 23
  3765.             BOYAN files 6, 7                  afterwards 24
  3766.  
  3767.  
  3768.     Index                                                           Page 57
  3769.  
  3770.  
  3771.  
  3772.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 58
  3773.  
  3774.  
  3775.                cycle number 14             file transfer 28
  3776.                directory                      auto-find filename
  3777.                   file ASCII copy               12, 29
  3778.                   26                          batch 31
  3779.                long-distance                  downloading 30
  3780.                  prefixes 26                     directory 11
  3781.                manual 23, 25                  efficiency 31
  3782.                modem command 14,              protocols
  3783.                  26, 38                          ASCII 29
  3784.             dialing directory 23,                CRC-Xmodem 29
  3785.                  24                              default 11, 30,
  3786.                alphabetizing 25                  31, 47
  3787.                codes 23, 25                      external 18, 31
  3788.                deleting 25                       G-Ymodem 29
  3789.                edit entry 25                     Kermit 31
  3790.                file ASCII copy 11                Megalink 31
  3791.                locate 25                         Message 29
  3792.                print 25                          Relaxed Xmodem 29
  3793.                swap 25                           Sealink 31
  3794.             DI macro command 44                  Xmodem 28
  3795.             Directory File Manager               Ymodem 29
  3796.                  32                              Zmodem 31
  3797.                sorting 10                     uploading 29, 32
  3798.             disk logging 11, 22                  directory 11
  3799.             DL macro command 46                  message 29, 30
  3800.             DM macro command 42            free disk space 11, 33
  3801.             DOS Shell 10, 20, 33,
  3802.                  34                        G
  3803.             DP macro command 47            GB script command 51
  3804.             DSZ.EXE 31                     GM macro command 42
  3805.             DT macro command 44            gossip mode 21
  3806.             DTR signal 6, 14, 15,          GS script command 52
  3807.                  17, 28                    GX macro command 42
  3808.             duplex toggle 21               GY macro command 42
  3809.  
  3810.             E                              H
  3811.             EB script command 51           hanging up 14, 28
  3812.             echo keyboard 21                  macro 15
  3813.             EC macro command 42            help screens 8
  3814.             elapsed-time clock 8           HN macro command 48
  3815.             Esc 8                          Host Mode 38
  3816.             exiting BOYAN 20               HU macro command 44
  3817.             EX macro command 47
  3818.                                            I
  3819.             F                              IF macro command 45
  3820.             features 1                     Ins 33
  3821.             FE macro command 45            IP macro command 45
  3822.             file size information          IS macro command 45
  3823.                  32, 33                    IT macro command 46
  3824.  
  3825.  
  3826.  
  3827.  
  3828.  
  3829.  
  3830.  
  3831.     Index                                                           Page 58
  3832.  
  3833.  
  3834.  
  3835.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 59
  3836.  
  3837.  
  3838.             IV script command 52           MS macro command 49
  3839.             IW macro command 46
  3840.                                            N
  3841.             J                              ND macro command 47
  3842.             JD macro command 47            new drive/directory 32,
  3843.             Jump to DOS 10, 20, 34              33
  3844.  
  3845.             K                              P
  3846.             KM macro command 48            P: macro command 48
  3847.             KO macro command 48            PA macro command 41
  3848.             KV script command 52           parameter change 14, 23
  3849.                                            PCKERMIT.EXE 31
  3850.             L                              PgDn 30
  3851.             LD macro command 42            PgUp 29
  3852.             LeftArrow 36                   phone call log 31
  3853.             LF macro command 42            PI macro command 42
  3854.             licensing 3                    PL macro command 44
  3855.             line editor 8                  printer
  3856.                                               configuration 10
  3857.             M                                 dialing directory 25
  3858.             macro commands 40                 initialize 42
  3859.                basic 40                       interface 22
  3860.                conditional 45                 logging 22
  3861.                DOS/File 46                    screen 22
  3862.                examples 53                    scroll-back buffer
  3863.                flow 49                          35
  3864.                input/output 41             PR macro command 43
  3865.                miscellaneous 47            PS macro command 43
  3866.                modem 43                    PU macro command 41
  3867.                pausing 41
  3868.                string replacements         Q
  3869.                  48                        QA macro command 44
  3870.                trace 48                    QC macro command 44
  3871.             macros 13, 35, 39              QD macro command 44
  3872.                alt-function key 16         questions & answers 37
  3873.                Alt-number 16               queue redialer 27
  3874.                ctrl-function key 16           add 27
  3875.                function key 16                alarm 28
  3876.                shift-function key             clear 27
  3877.                  16                           delete 27
  3878.                shortcut 15, 26                macro 15
  3879.             MA macro command 49            QU macro command 44
  3880.             MD macro command 48
  3881.             memory usage 10                R
  3882.             MLINK.EXE 31                   RC macro command 43
  3883.             MM macro command 49            registration 3
  3884.             MN macro command 48            RE macro command 49
  3885.             modem messages 13              renaming files 33
  3886.             modem settings                 reviews 4
  3887.                Hayes 14                    RightArrow 37
  3888.                parity 7, 12                RV script command 52
  3889.                port 7, 12, 38              RX macro command 43
  3890.                speed 7, 12                 RY macro command 43
  3891.             MP macro command 49
  3892.  
  3893.  
  3894.     Index                                                           Page 59
  3895.  
  3896.  
  3897.  
  3898.     BOYAN-D3 Communications         (C) Copyright 1986,1987         Page 60
  3899.  
  3900.  
  3901.                                            translate table 22
  3902.             S                              TR macro command 48
  3903.             SA macro command 43            TT macro command 43
  3904.             SB macro command 45
  3905.             screen dump 11, 22             U
  3906.             script commands                UF macro command 47
  3907.                examples 54                 UI macro command 46
  3908.                summary 52                  UL macro command 47
  3909.                variable 52                 UM macro command 47
  3910.             script files 39                UN macro command 41
  3911.                auto-session 50             Usage Log 31
  3912.                blocks 35, 49               usage log file 11
  3913.                definitions 40              user groups 3
  3914.                examples 39                 using default text
  3915.                logon 50                         color 22
  3916.                naming 49                   using the manual 2
  3917.                overview 39                 UT macro command 41
  3918.                running 33, 35, 50
  3919.             scroll-back buffer 10,         V
  3920.                  11, 34                    viewing files 10, 33,
  3921.             SC script command 52                34
  3922.             Shift-PrtSc 22                 VT100 emulation 38
  3923.             Shift-Tab 21                   VV script command 52
  3924.             shortcut macros 15, 26
  3925.             site license 3                 W
  3926.             SM macro command 48            welcome screen 7
  3927.             SN macro command 48            WF macro command 41
  3928.             source code 38                 WL macro command 41
  3929.             SS macro command 43            word wrap auto-
  3930.             start-up macro 15                   detection 12, 30
  3931.             startup 6                      WP macro command 41
  3932.             status line 7                  WW macro command 47
  3933.             stop bits 38
  3934.             SV script command 52           X
  3935.             system requirements 6          XP macro command 49
  3936.                disk 6                      XX macro command 43
  3937.                display 6
  3938.                DOS 6                       Y
  3939.                memory 6, 7, 10             YP macro command 49
  3940.                modem 6
  3941.                                            Z
  3942.             T                              zap screen 20
  3943.             terminal mode 7                ZS macro command 43
  3944.             TO macro command 48
  3945.  
  3946.  
  3947.  
  3948.  
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.     Index                                                           Page 60
  3958.